vscode无法正常安装esp-idf插件原因及解决办法

问题:老是无法正常安装使用esp-idf，总是走到创建工程项目时状态栏一直转圈就没有下文，反复安装卸载几次依然如此。

原因及解决办法:之前装过 Python、PyCharm，系统 PATH 里很可能混进了多条 Python、pip、conda、Git 路径，ESP-IDF 扩展和 EIM 就会被这些旧环境干扰。 最稳的办法不是“逐个修复”，而是先把 Python 和 ESP-IDF 相关残留清干净，再重新装。

第一步：先卸载 Python 和 PyCharm

1. 打开 设置 → 应用 → 已安装的应用，搜索：

- Python

- PyCharm

- Anaconda

- Miniconda

- Git

2. 把不需要的 Python 版本、PyCharm、Anaconda/Miniconda 都卸载。

3. 如果 Git 是之前专门为了 ESP-IDF 装的，也可以先卸载；如果其他软件还要用，就先保留。

第二步：删除残留文件夹

按 Win + R，输入：

%USERPROFILE%

然后手动删除这些目录里和 Python、ESP-IDF 有关的内容：

C:UsersztAppDataLocalProgramsPython

C:UsersztAppDataRoamingPython

C:UsersztAppDataLocalpip

C:Userszt.espressif

C:Userszt.vscodeextensionsespressif.esp-idf-extension-*

C:Userszt.vscodeextensionsespressif.esp-idf-tools-*

C:Espressif

D:ESP

D:esp

如果删除时提示“文件被占用”，先关闭：

- VS Code

- PyCharm

- ESP-IDF CMD / PowerShell

- 所有终端窗口

必要时重启电脑再删。

第三步：清理环境变量

按 Win + R，输入：

sysdm.cpl

打开 高级 → 环境变量。

分别在 用户变量 和 系统变量 里检查：

- Path：删除包含 Python、Scripts、pip、Anaconda、conda、esp-idf、Espressif、idf.py 的路径；

- 如果存在这些变量，也删除：

- PYTHONPATH

- PYTHONHOME

- IDF_PATH

- IDF_TOOLS_PATH

- CONDA_DEFAULT_ENV

- CONDA_PREFIX

注意不要整行删除 Path，只删其中和 Python、ESP-IDF 相关的条目。

第四步：清理注册表

按 Win + R，输入：

regedit

找到并删除：

HKEY_CURRENT_USERSoftwarePython

HKEY_LOCAL_MACHINESOFTWAREPython

HKEY_LOCAL_MACHINESOFTWAREWOW6432NodePython

删除前可以右键导出备份一下。

第五步：重启后验证是否干净

重启电脑，打开新的 CMD 或 PowerShell，依次执行：

python --version

pip --version

where python

idf.py --version

如果都提示“不是内部或外部命令”，说明旧环境基本清理干净了。

第六步：重新安装 ESP-IDF

完美解决。