针对VSCode安装Python扩展时卡在“正在安装”状态的问题，核心原因通常与网络连接、插件市场访问、缓存冲突或环境配置有关。以下是系统性的解决方案，按排查优先级排序。 ### **1. 网络与代理问题排查** 这是最常见的原因，尤其是在国内网络环境下访问VSCode官方扩展市场时。 | 操作步骤 | 具体命令/方法 | 说明 | | :--- | :--- | :--- | | **检查网络连接** | 在VSCode终端执行 `ping marketplace.visualstudio.com` | 若延迟高或丢包严重，说明网络不稳定[ref_5]。 | | **配置代理** | 在VSCode设置中搜索 `Proxy`，填入 `http://127.0.0.1:7890` (端口根据实际修改) | 使VSCode通过代理访问扩展市场[ref_5]。 | | **使用命令行安装** | `code --install-extension ms-python.python` | 绕过VSCode GUI，直接通过命令行安装[ref_5]。 | ### **2. 清除VSCode缓存与数据** 损坏的缓存或扩展数据会导致安装进程卡死。 1. **完全关闭VSCode**。 2. **删除缓存目录**（路径因操作系统而异）： * **Windows**: `%APPDATA%\Code\Cache` 和 `%APPDATA%\Code\CachedData` * **macOS**: `~/Library/Application Support/Code/Cache` 和 `~/Library/Application Support/Code/CachedData` * **Linux**: `~/.config/Code/Cache` 和 `~/.config/Code/CachedData` 3. 重新启动VSCode并重试安装[ref_5]。 ### **3. 离线安装扩展 (VSIX文件)** 这是解决网络问题最彻底的方法，直接从扩展市场下载安装包进行离线安装[ref_1]。 1. **获取VSIX文件**： * 访问 [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=ms-python.python)，找到Python扩展页面。 * 点击右侧的“Download Extension”按钮，下载 `.vsix` 文件到本地。 2. **在VSCode中安装**： * 打开VSCode，进入扩展视图 (`Ctrl+Shift+X`)。 * 点击扩展视图右上角的“...”更多操作按钮。 * 选择“从VSIX安装...”，然后定位并选择你下载的 `.vsix` 文件。 ```bash # 或者，你也可以使用命令行进行离线安装 code --install-extension /path/to/ms-python-python-xxx.vsix ``` ### **4. 检查并修复Python环境** 某些扩展（如PlatformIO）对Python环境有依赖，环境异常可能导致安装进程阻塞[ref_6]。虽然Python扩展本身不依赖外部Python，但检查环境是良好的排错习惯。 1. **确认系统Python可用**： ```bash # 在系统终端或VSCode内置终端中执行 python --version # 或 python3 --version ``` 2. **如果缺少Python**，需先安装。在VSCode中配置Python解释器是后续步骤，但一个可用的系统Python环境有助于排除底层依赖问题[ref_2][ref_3]。 ### **5. 禁用其他扩展或安全软件** 部分安全软件（如防火墙、杀毒软件）或已安装的扩展可能会干扰新扩展的安装进程。 * **以管理员身份运行VSCode**（Windows系统）。 * **暂时禁用所有已安装的扩展**，然后尝试重新安装Python扩展。 * **临时关闭防火墙或杀毒软件**，观察是否安装成功。 ### **6. 重置或重装VSCode** 如果以上方法均无效，可能是VSCode本身损坏。 1. **重置用户数据**：备份后，删除用户数据目录（`%APPDATA%\Code` on Windows, `~/Library/Application Support/Code` on macOS, `~/.config/Code` on Linux）。 2. **完全卸载后重装**：确保卸载时勾选“删除用户数据”，然后从官网下载最新版本重新安装[ref_4][ref_5]。 ### **总结与建议流程** 建议按以下顺序尝试： 1. **首选离线安装**：下载VSIX文件进行安装，这是绕过网络问题最直接有效的方法[ref_1]。 2. **检查网络与代理**：配置代理或使用命令行安装。 3. **清理缓存**：删除VSCode的缓存目录。 4. **检查环境与冲突**：确认Python环境，并尝试在禁用其他扩展的情况下安装。 5. **终极方案**：重置或重装VSCode。 通常，执行**离线安装（第1步）** 或**配置代理并清理缓存（第2、3步）** 后，问题即可解决。