Python扩展卡在“正在下载”是因VS Code无法访问marketplace.visualstudio.com，需配置http.proxy并设http.proxyStrictSSL为false，或手动下载正确.vsix文件安装。
Python扩展卡在“正在下载”不动
这基本是网络连不上 marketplace.visualstudio.com 导致的，不是插件本身坏了。VS Code 默认不走系统代理，也不读 http_proxy 环境变量，国内用户尤其常见。
打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，切到 Network 标签页，再点一次更新，看有没有对 marketplace.visualstudio.com 或 vscode-api 的请求失败（状态码为 0 或 timeout）。
- 确认是网络问题后，在设置里搜
http.proxy，填入你的代理地址（如http://127.0.0.1:7890），并把http.proxyStrictSSL设为false - 临时绕过：浏览器打开
https://marketplace.visualstudio.com/items?itemName=ms-python.python，点右下角Download Extension，得到类似ms-python.python-2026.4.1.vsix的文件 - 然后用命令面板运行
Extensions: Install from VSIX，选中该文件安装
手动下载的 .vsix 安装失败
你点开插件页，看到“请尝试手动下载”，结果选了 Microsoft.VisualStudio.Services.VSIXPackage 文件——这是错的。这个文件不是标准 .vsix，VS Code 不认。
正确做法是：在插件详情页点击右上角齿轮图标 → 选 Download Specific Version，或直接点倒数第三个选项 Download VSIX（不是“Download Extension”按钮旁那个小链接）。
立即学习“Python免费学习笔记（深入）”；
- 下载下来的文件名必须以
.vsix结尾，且不含空格或特殊字符 - 如果下载后提示“损坏”或“无法安装”，检查文件大小是否明显偏小（
- 安装时若报
Extension is not compatible with current version of VS Code，说明 .vsix 要求的引擎版本（如^1.90.0）高于你当前 VS Code 版本（如1.88.2），得降级 VS Code 或换旧版 .vsix
Remote-SSH 场景下 Python 插件更新失败
你在本地点了“安装”，实际执行的是远程服务器上的 vscode-server 进程。它不读你本地的代理，也不认你本地的 .vsix 文件。
必须把 .vsix 文件传到远程机器上再装：
- 用
scp或 SFTP 把ms-python.python-*.vsix上传到远程任意路径（如~/tmp/） - SSH 登录后执行：
code --install-extension ~/tmp/ms-python.python-2026.4.1.vsix - 如果提示
command not found: code，说明vscode-server没把code注入PATH，改用绝对路径：~/.vscode-server/bin/<hash>/bin/code --install-extension ~/tmp/ms-python.python-2026.4.1.vsix</hash>（<hash></hash>是当前 server 版本号，可在~/.vscode-server/bin/下查看） - 装完必须重连 Remote-SSH，否则新插件不会激活
更新后 Python 功能异常或报 Cannot find module
不是插件没装好，而是缓存没清干净。新版插件依赖的 node_modules 可能和旧版残留冲突，尤其是从 v2025.x 升到 v2026.x 后。
别急着重装，先清缓存：
- 关闭 VS Code
- 删掉对应扩展目录下的
node_modules（路径如~/.vscode/extensions/ms-python.python-2026.4.1/node_modules） - 重启 VS Code，它会自动重建依赖
- 如果还报
Cannot find module 'vscode-languageclient'，说明 LSP 客户端没 resolve，检查settings.json是否残留废弃配置（如旧版 Prettier 的prettier.semi）
Python 插件的语言服务组件（如 Pylance）是独立发布的，离线安装时容易漏掉——它不包含在主 .vsix 里，得单独去 marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance 下载安装。
