VSCode插件安装失败90%源于网络、权限、缓存或配置冲突，非插件本身问题；需优先检查extensions.gallery.serviceUrl镜像源、清除错误http.proxy、验证.vsix兼容性及签名校验机制。
VSCode插件安装失败，90% 和网络、权限、缓存或配置层级冲突有关，不是插件本身坏了，也不是你操作错了——而是 VSCode 在某个环节静默卡住了。
Extensions: Install from VSIX 提示 Unable to load extension
这不是文件损坏，是 VSCode 仍尝试联网校验签名。哪怕你断网拖进来了，它也会先发请求，失败后才退到本地加载，而这个过程可能被跳过或中断。
- 必须先断网，再启动 VSCode，再拖入
.vsix文件（否则卡在 fetch 阶段） - 或临时关掉校验：
settings.json加"extensions.installVerification": false（仅调试用，验证完记得删） - 检查
.vsix解压后的package.json中engines.vscode字段，比如你本地是1.92.0，但插件写的是"^1.93.0"，就真不兼容 - Windows 用户避免路径含中文或空格（如
C:\Users\张三或C:\Program Files），VSCode 启动时传给 Node.js 子进程的路径未转义会直接崩
安装卡在 “Installing…” 或报 Failed to fetch
VSCode 1.85+ 默认连的是 open-vsx.org，但国内 DNS 经常解析失败或 fallback 到已停用的旧地址，导致静默 404。
- 最快验证方式：打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），切到Network标签，点一次安装，看请求发往哪个域名、是否超时 - 临时换源最稳：在
settings.json里加这两行（注意逗号）："extensions.gallery.serviceUrl": "https://vscode-ext.oss-cn-shenzhen.aliyuncs.com/gallery/""extensions.gallery.itemUrl": "https://vscode-ext.oss-cn-shenzhen.aliyuncs.com/gallery/item" - 别改系统代理——VSCode 不继承环境变量里的
HTTP_PROXY，得在设置里显式填http.proxy - 删掉临时目录：
~/.vscode/.extensions-tmp（Linux/macOS）或%USERPROFILE%\.vscode\.extensions-tmp（Windows），这个目录被杀软拦截后，VSCode 不报错，只干等
中文语言包装了但界面还是英文
不是插件没装上，而是 VS Code 根本没“决定”用它。1.70+ 版本只认 locale.json 配置，其他地方写的 locale 都无效。
- 必须用
Ctrl+Shift+P执行Configure Display Language，列表里选zh-cn（不是zh、Chinese或zh-hans） - 选完后弹出提示，必须点
Restart——托盘进程（Code Helper）不退出会导致配置未加载 -
locale.json路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 内容必须是合法 JSON：
{"locale": "zh-cn"}（双引号、冒号后有空格、值为小写，不能是"zh_CN"或"zh-Hans"）
Extension host terminated unexpectedly 错误怎么定位
这个错误不是插件没装上，而是已安装的某个插件在激活时崩溃了扩展主机进程，导致所有插件功能失效（比如语法高亮、代码补全突然消失）。
- 常见于更新后、Node.js 版本不匹配、或插件调用了被 VS Code 移除的 API
- 先用
code --disable-extensions启动，再逐个启用插件排查 - 检查
~/.vscode/extensions/下是否有残留的半安装文件夹（名称含.incomplete或时间戳异常），直接删掉 - 某些插件（如 Prettier、ESLint）需额外安装全局 CLI 工具，仅装插件不够——查其 README 是否要求
npm install -g eslint
最容易被忽略的点是：VSCode 的扩展系统本身可能已损坏，而不是某一个插件的问题。命令面板里 Extensions: Show Installed Extensions 打不开、空白页或报 command 'workbench.extensions.action.showInstalledExtensions' not found，说明扩展视图已崩溃——此时重装插件毫无意义，必须完全退出进程再重试。
