最准确认Python插件是否装上:执行code --list-extensions | grep python(macOS/Linux)或code --list-extensions | findstr python(Windows),仅输出ms-python.python才表示核心插件已正确安装;若无输出、仅ms-python.pylance或@installed python搜索为空,则未安装。

插件根本没装上,怎么确认?
别信 Extensions 面板里“已安装”的显示,它常误报。最准的方法是命令行验证:code --list-extensions | grep python(macOS/Linux)或 code --list-extensions | findstr python(Windows)。只应输出 ms-python.python 才算核心插件到位;若为空、或只输出 ms-python.pylance,说明主插件缺失。
- 执行
Ctrl+Shift+P → 输入 Extensions: Show Installed Extensions,再搜 @installed python
- 若结果为空,就是没装;若只有 Pylance/Jupyter,说明装了周边但漏了主包
- 远程环境(SSH/WSL/Dev Container)里装的插件,对本地窗口完全无效——状态栏右下角没出现 Python 解释器选项,大概率是环境错位
安装卡在 “Installing…” 或报 XHR failed 怎么办?
这不是插件问题,而是 VS Code 请求 marketplace.visualstudio.com 时网络链路断了。常见于 DNS 污染、企业防火墙拦截、代理配置错误,或 VS Code 1.85+ 默认 fallback 到已失效的旧地址。
- 打开设置搜索
http.proxy,删掉错配的代理项(比如你没开 Fiddler 却写了 <a href="https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365">https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365</a>)
- 终端执行
curl -v <a href="https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1">https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1</a>,看是否同样失败
- 临时改市场源:在
settings.json 中加这两行(注意末尾斜杠): "extensions.autoUpdate": false<br>"extensions.gallery.serviceUrl": "https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1/_apis/public/gallery/"
- 更稳的是离线安装:去官网下载
ms-python.python-*.vsix,再用命令面板执行 Extensions: Install from VSIX
装上了但不生效,常见激活失败原因Extension activation failed 报错背后,往往是版本兼容、依赖缺失或路径冲突。
- 查插件页面的
engines.vscode 字段,比如 "^1.75.0" 表示最低需 1.75;你用 1.91.0 就行,但若插件只声明到 1.79.0,1.80+ 可能被拒绝加载
- 某些插件(如 Prettier、ESLint)需额外装全局 CLI:
npm install -g eslint,否则功能残缺
- 安装路径含中文?Git、Python 调试器、C++ 插件会直接崩——必须重装 VS Code 到纯英文路径,比如
C:\tools\vscode,改配置无效
- 插件缓存损坏:执行
Ctrl+Shift+P → Developer: Reload Window,再不行就手动删掉 ~/.vscode/extensionsCache/ 目录
中文界面装了但还是英文?关键一步漏了
装插件只是提供翻译资源,VS Code 不会自动启用。唯一生效路径是执行 Configure Display Language 命令并选 zh-cn,然后点 Restart。
- 必须用
Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS)打开命令面板,输全名执行
- 列表里只认
zh-cn,不是 zh、Chinese 或 zh-hans(后者是插件 ID,非运行时 locale 值)
- 重启必须点弹窗里的
Restart,仅关闭再手动打开,Code Helper 进程还在,配置不加载
- 文件
locale.json 必须存在且内容为 {"locale": "zh-cn"},路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json
Ctrl+Shift+P → 输入 Extensions: Show Installed Extensions,再搜 @installed python - 打开设置搜索
http.proxy,删掉错配的代理项(比如你没开 Fiddler 却写了<a href="https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365">https://www.php.cn/link/1ce5e897cda6aeb211dffe8d514f4365</a>) - 终端执行
curl -v <a href="https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1">https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1</a>,看是否同样失败 - 临时改市场源:在
settings.json中加这两行(注意末尾斜杠):"extensions.autoUpdate": false<br>"extensions.gallery.serviceUrl": "https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1/_apis/public/gallery/"
- 更稳的是离线安装:去官网下载
ms-python.python-*.vsix,再用命令面板执行Extensions: Install from VSIX
装上了但不生效,常见激活失败原因Extension activation failed 报错背后,往往是版本兼容、依赖缺失或路径冲突。
- 查插件页面的
engines.vscode 字段,比如 "^1.75.0" 表示最低需 1.75;你用 1.91.0 就行,但若插件只声明到 1.79.0,1.80+ 可能被拒绝加载
- 某些插件(如 Prettier、ESLint)需额外装全局 CLI:
npm install -g eslint,否则功能残缺
- 安装路径含中文?Git、Python 调试器、C++ 插件会直接崩——必须重装 VS Code 到纯英文路径,比如
C:\tools\vscode,改配置无效
- 插件缓存损坏:执行
Ctrl+Shift+P → Developer: Reload Window,再不行就手动删掉 ~/.vscode/extensionsCache/ 目录
中文界面装了但还是英文?关键一步漏了
装插件只是提供翻译资源,VS Code 不会自动启用。唯一生效路径是执行 Configure Display Language 命令并选 zh-cn,然后点 Restart。
- 必须用
Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS)打开命令面板,输全名执行
- 列表里只认
zh-cn,不是 zh、Chinese 或 zh-hans(后者是插件 ID,非运行时 locale 值)
- 重启必须点弹窗里的
Restart,仅关闭再手动打开,Code Helper 进程还在,配置不加载
- 文件
locale.json 必须存在且内容为 {"locale": "zh-cn"},路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json
engines.vscode 字段,比如 "^1.75.0" 表示最低需 1.75;你用 1.91.0 就行,但若插件只声明到 1.79.0,1.80+ 可能被拒绝加载 npm install -g eslint,否则功能残缺 C:\tools\vscode,改配置无效 Ctrl+Shift+P → Developer: Reload Window,再不行就手动删掉 ~/.vscode/extensionsCache/ 目录Configure Display Language 命令并选 zh-cn,然后点 Restart。
- 必须用
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)打开命令面板,输全名执行 - 列表里只认
zh-cn,不是zh、Chinese或zh-hans(后者是插件 ID,非运行时 locale 值) - 重启必须点弹窗里的
Restart,仅关闭再手动打开,Code Helper进程还在,配置不加载 - 文件
locale.json必须存在且内容为{"locale": "zh-cn"},路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json
复杂点在于多层覆盖:工作区 .vscode/settings.json 里写 "locale": "en"、远程容器独立配置、甚至 IT 策略组(GPO)都可能把 zh-cn 覆盖回英文。真要排查,得先关掉工作区再试。


















