PlatformIO 完整迁移C盘到D盘实操指南（全程排错+最终成功版）

可以把这篇文章发给豆包让豆包给个完整步骤一、实验目的解决 PlatformIO 默认安装在C盘长期占用系统盘、导致C盘爆红、电脑卡顿问题将 PlatformIO 所有核心环境、缓存、虚拟环境完整迁移至D盘实现零C盘占用、永久稳定运行。二、初始问题与报错现象迁移前故障汇总默认路径C:\Users\Shanhai\.platformio 占用大量C盘空间VSCode PlatformIO 插件启动超时、卡死、无限安装 Core报错目录路径拼接错乱 C:\Users\Shanhai\ D:\xxx 非法路径报错WinError 123 文件名/目录名语法错误插件提示找不到 Python 环境、penv 虚拟环境失效无代理情况下出现 proxy 127.0.0.1:7897 代理报错系统残留配置导致查看报错可以打开vscode的帮助选项-切换开发人员工具三、核心故障根源总结本次最大坑点仅复制文件夹无法迁移直接剪切C盘.platformio到D盘虚拟环境 penv 内部硬编码绑定旧C盘路径直接报废环境变量不重启不生效配置 PLATFORMIO_CORE_DIR 后不重启电脑VSCode 依旧读取旧C盘路径导致路径拼接错乱VSCode配置拼写错误customPyPIndexUrl 多写一个P镜像源失效导致在线安装卡死、下载超时系统残留代理缓存无代理软件但系统/VSCode残留旧代理配置导致GitHub资源404、拉取失败自动安装流程极易卡死PIO在线自动重建虚拟环境网络不稳定百分百卡住四、实验准备工作目标迁移目录D:\PlatformIO\.platformio本地Python环境D:\Python3.14.2系统全局可用关闭所有代理、VPN清空系统及VSCode代理配置完全退出VSCode包括右下角托盘后台进程五、完整实操迁移步骤最终成功流程步骤1新建D盘存放目录在D盘手动创建文件夹D:\PlatformIO\.platformio手动提前创建子目录避免程序自动创建路径出错D:\PlatformIO\.platformio\.cache步骤2配置系统核心环境变量最关键WinR 输入sysdm.cpl打开系统属性高级 → 环境变量 → 用户变量 新建变量名PLATFORMIO_CORE_DIR变量值D:\PlatformIO\.platformio无任何空格一定要注意不要有空格保存设置必须重启电脑生效步骤3清空所有残留代理配置Windows设置 → 网络和Internet → 代理 → 关闭所有代理服务控制面板 → Internet选项 → 连接 → 局域网设置 → 取消代理勾选VSCodesettings.json清空所有 proxy 相关配置删除系统环境变量中HTTP_PROXY/HTTPS_PROXY残留项步骤4修正VSCode PlatformIO正确配置打开VSCodesettings.json写入无错误、无空格的最终配置{ platformio-ide.customPATH: D:\\PlatformIO\\.platformio\\penv\\Scripts, platformio-ide.customPythonPath: D:\\PlatformIO\\.platformio\\penv\\Scripts\\python.exe, platformio-ide.customPyPiIndexUrl: https://pypi.tuna.tsinghua.edu.cn/simple }修复历史错误删除多余P修正镜像键名配置本地Python、Scripts路径步骤5手动纯净重建虚拟环境避开卡死BUG确保无旧penv残留删除D:\PlatformIO\.platformio\penv打开CMD按winR,在输入框输入cmd手动创建全新虚拟环境python -m venv D:\PlatformIO\.platformio\penv使用清华镜像手动安装PlatformIO核心解决网络卡死D:\PlatformIO\.platformio\penv\Scripts\pip.exe install platformio -i https://pypi.tuna.tsinghua.edu.cn/simple步骤6最终验证迁移成功新开CMD执行验证命令D:\PlatformIO\.platformio\penv\Scripts\pio.exe --version输出PlatformIO Core, version 6.1.19无报错即为完全成功六、收尾优化释放C盘确认D盘环境完全正常后删除C盘残留旧目录C:\Users\Shanhai\.platformio彻底释放C盘存储空间后续所有PlatformIO缓存、库、工具链均存储在D盘。七、本次实验踩坑总结关键避坑点操作结果说明❌ 直接剪切复制.platformio文件夹虚拟环境路径绑定C盘直接报废仅复制文件夹无法迁移❌ 修改环境变量不重启电脑VSCode读取旧路径造成路径拼接错乱报错环境变量不重启不生效❌ 键名拼写错误、镜像源失效在线安装无限卡死VSCode配置拼写错误❌ 依赖插件自动安装网络问题百分百卡住自动安装流程极易卡死✅ 配置环境变量重启系统手动新建虚拟环境国内镜像离线安装迁移成功无C盘占用正确方案八、最终实验结果✅ PlatformIO 环境完整迁移至 D盘无C盘占用✅ pio 命令正常识别版本号读取成功✅ 无路径拼接错误、无Python缺失报错、无安装卡死问题✅ VSCode PlatformIO 插件可正常启动、编译、烧录、打开串口监视器✅ 彻底解决C盘爆红、环境损坏、启动超时、网络报错等所有问题