插件安装失败90%非插件问题，而是VS Code扩展系统链路中断所致；须逐层排查：先验证extensionHost进程是否崩溃（Extensions: Show Installed Extensions无响应则需彻底杀进程并禁用扩展重启），再检查Network面板有无marketplace请求、.incomplete残留、路径权限及远程/本地环境错位。
插件安装失败，90% 不是插件本身的问题，而是 VS Code 扩展系统某一层卡住了——网络不通、进程崩溃、缓存错乱或路径权限异常，必须按链路逐层验证，不能靠重试或重装。
Extensions: Show Installed Extensions 无响应
这是最容易被跳过的第一个断点：你根本不是“装不上”，而是扩展界面已经失活。命令面板输入 Extensions: Show Installed Extensions 后白屏、卡顿或报 command 'workbench.extensions.action.showInstalledExtensions' not found，说明 extensionHost 进程已崩溃。
- 必须彻底退出所有 VS Code 进程：Windows 杀掉全部
Code.exe和Code Helper.exe；macOS 查Code和Code Helper (Renderer)；Linux 用ps aux | grep code - 重启时加
--disable-extensions参数启动：code --disable-extensions，再逐个启用关键插件（如ms-python.python），定位是否某个插件拖垮 host - 检查
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下是否有残留的.incomplete文件夹，直接删掉
Network 面板看不到 marketplace 请求
点击 Install 后状态栏卡在 “Installing…”、Network 面板里压根没出现任何对 marketplace.visualstudio.com 的请求，说明请求根本没发出去——不是超时，是阻断。
- 打开
Help → Toggle Developer Tools → Network，复现安装动作，观察是否有https://marketplace.visualstudio.com/_apis/public/gallery/请求 - 若请求完全不出现：检查
http.proxy是否显式配置（VS Code 不继承系统HTTP_PROXY环境变量）；禁用 Clash/Fiddler/火绒等代理或安全软件 - 若请求返回
ERR_CONNECTION_RESET或 403：大概率是企业防火墙拦截了vscode.blob.core.windows.net域名，需联系 IT 部门放行 - 临时验证连通性：终端执行
curl -v https://marketplace.visualstudio.com，看 TLS 握手是否成功
离线安装 .vsix 后提示 “not compatible with VS Code”
错误信息含 ms-ceintl.vscode-language-pack-zh-hans 和 not compatible with VS Code '1.xxx'，本质是 package.json 中的 engines.vscode 字段版本声明不匹配，不是包坏了。
- 用 7-Zip 或
unzip解压.vsix（它就是 ZIP），进入extension/package.json（注意不是根目录那个） - 将
"vscode": "^1.103.0"改为当前 VS Code 版本兼容的范围，例如你的code --version输出是1.91.0，就改写成"vscode": ">=1.91.0" - 用
zip -r plugin.vsix *（Linux/macOS）或 7-Zip 重新打包，后缀名必须是.vsix；Windows 资源管理器双击解压再压缩会破坏 ZIP 结构 - 务必通过命令面板运行
Extensions: Install from VSIX安装，不要拖进窗口“假装安装”
装上了但右下角没 Python 解释器、▶️ 按钮消失
这往往不是插件问题，而是环境错位：你把插件装在了 Remote-SSH / WSL / Dev Container 里，而当前窗口是 Local 环境，两者完全隔离。
- 看左下角状态栏：出现
<> SSH: xxx、<> WSL: Ubuntu或<> Dev Container，就说明你在远程上下文中 - 必须先执行
File → Close Remote Connection切回 Local 窗口，再安装ms-python.python - Remote 环境要单独装一次——本地插件不会自动同步过去，也不能跨环境生效
- 确认是否真装上了：终端执行
code --list-extensions | grep python（macOS/Linux）或code --list-extensions | findstr python（Windows），只应输出ms-python.python
最常被忽略的是 locale.json 路径和格式：文件必须在正确位置、内容严格为 {"locale": "zh-cn"}（小写、双引号、冒号后有空格），且必须通过 Configure Display Language 命令触发写入并彻底重启——点关闭再手动打开不算重启，后台进程不退出，配置就不加载。
