插件安装失败时先检查 Extensions: Show Installed Extensions 是否能正常打开，若命令无响应、空白页或报错说明扩展系统已损坏；需完全退出 VS Code 进程后重试，或用 --disable-extensions 启动排查。
插件安装失败时先看 Extensions: Show Installed Extensions 能不能打开
很多所谓“安装失败”其实是 VS Code 扩展视图本身卡住或崩溃了，不是网络或权限问题。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Extensions: Show Installed Extensions 并回车——如果命令无响应、空白页、或报错 command 'workbench.extensions.action.showInstalledExtensions' not found，说明扩展系统已损坏。
实操建议：
- 重启 VS Code，**不要直接关窗口，要完全退出进程**（任务管理器/活动监视器里确认
Code Helper、Code进程都已结束） - 启动时加
--disable-extensions参数：终端执行code --disable-extensions，再手动启用关键插件逐个排查 - 检查
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）目录下是否有残留的半安装文件夹（名称含.incomplete或时间戳异常），直接删掉
下载卡在 0% 或提示 Failed to fetch 的真实原因
VS Code 默认走微软官方扩展市场（marketplace.visualstudio.com），但国内直连常因 DNS 污染或 TLS 握手失败中断，表现为进度条不动、控制台输出 ERR Failed to fetch: https://marketplace.visualstudio.com/...，而不是明确的网络超时。
实操建议：
- 临时换源最稳：在设置 JSON（
settings.json）里加一行"extensions.autoUpdate": false和"extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery"—— 注意末尾别少/，否则 404 - 不推荐全局代理：VS Code 不继承系统代理环境变量，需手动配置
http.proxy和http.proxyStrictSSL: false，但后者会削弱安全校验，容易触发证书错误 - 手动下载安装更可靠：去
https://marketplace.visualstudio.com/items?itemName=作者名.插件名页面点「Download Extension」，得到.vsix文件，再用命令面板运行Extensions: Install from VSIX...
Extension host terminated unexpectedly 错误怎么定位
这个错误不是插件没装上，而是已安装的某个插件在激活时崩溃了扩展主机进程，导致所有插件功能失效（比如语法高亮、代码补全突然消失）。常见于更新后、Node.js 版本不匹配、或插件调用了被 VS Code 废弃的 API（如 vscode.workspace.rootPath）。
实操建议：
- 打开开发者工具（
Help → Toggle Developer Tools），切到Console标签页，找红色报错行，重点看堆栈里第一个非vscode:开头的路径，就是肇事插件 - 禁用可疑插件后，必须重启扩展主机：按
Ctrl+Shift+P→ 输入Developer: Restart Extension Host，不要只刷新窗口 - 检查插件兼容性：在插件详情页看
engines.vscode字段是否匹配你当前 VS Code 版本（比如插件要求^1.80.0，而你用的是1.75.1） - 某些插件（如
GitLens、ESLint）依赖本地 Node.js，若系统 PATH 里 Node 版本太老（v12或更低），会静默失败，建议统一用 VS Code 内置 Node（process.versions.node在 DevTools 里查）
插件能装上但不生效：路径权限和 workspace 隔离问题
尤其在 macOS 或 Linux 上，插件写入文件（比如 Prettier 格式化时改 .prettierrc）、读取项目根目录下的配置、或监听 node_modules 变化时，可能因权限不足或工作区限制被拦截。现象是插件图标显示已启用，但右键菜单没选项、快捷键无效、状态栏无信息。
实操建议：
- 检查 VS Code 启动方式：如果从终端用
sudo code .打开项目，后续所有插件都以 root 权限运行，但用户目录下的配置（如~/.eslintcache）不可写，直接失败；应始终用普通用户启动 - 多根工作区（multi-root workspace）下，插件默认只对第一个文件夹生效；需要在
.code-workspace文件里显式配置"extensions": { "recommendations": [...] }并确保插件支持多文件夹 - 某些插件（如
Live Server）依赖file://协议访问本地 HTML，若项目路径含中文、空格或符号（如~/my project/），会拒绝加载，改用英文路径重试
真正麻烦的从来不是装不上，而是装上了却不知道它在哪一步悄悄放弃了——比如一个插件在初始化时读配置失败，就静默退出，连日志都不打。打开 Developer: Open Logs Folder，翻 exthost.log 最底几行，比猜快得多。
