插件安装失败90%非插件问题，而是扩展系统崩溃、网络无法直连marketplace.visualstudio.com或本地缓存/权限错乱所致；须按层排查：先确认extensions: show installed extensions是否响应，再查网络连通性、清理.incomplete残留、换国内镜像源、验证环境上下文及激活日志。
插件安装失败，90% 不是插件本身坏了，而是 VS Code 的扩展系统卡死、网络根本连不上 marketplace、或本地缓存/权限状态错乱导致的。重装 VS Code 或反复点“重试”基本没用，得按链路一层层往下查。
Extensions: Show Installed Extensions 打不开怎么办
这是最常被跳过的第一个故障点：你根本不是装不上插件，而是 VS Code 的扩展界面已经崩溃了。命令面板输入 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 查code相关进程 - 重启时加
--disable-extensions参数启动：code --disable-extensions，再逐个启用 Python、Pylance 等关键插件，定位是否某个插件拖垮了 host - 检查
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下是否有残留的.incomplete文件夹，直接删掉
安装卡在 “Installing…” 或报 Failed to fetch
VS Code 默认连 https://marketplace.visualstudio.com，国内直连常因 DNS 污染或 TLS 握手失败静默中断，表现为进度条不动、控制台出现 ERR Failed to fetch: https://marketplace.visualstudio.com/，而非明确超时。
- 别依赖系统代理——VS Code 不自动继承
HTTP_PROXY环境变量；手动配http.proxy且设http.proxyStrictSSL: false会削弱证书校验，容易触发后续激活失败 - 换源更稳：在
settings.json中添加（注意末尾斜杠）："extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery/" - 临时禁用自动更新避免干扰：
"extensions.autoUpdate": false - 验证网络是否真通：
curl -v https://marketplace.visualstudio.com，若卡在 TLS handshake 或返回 403，就是网络层被拦截
手动安装 .vsix 后插件仍不生效
VS Code 在加载本地 .vsix 前，仍会尝试联网校验签名。哪怕你断网拖进来了，它也会先发请求；失败后才退到本地加载，而这个过程可能被跳过或中断。
- 必须先彻底断网（关 Wi-Fi / 拔网线），再启动 VS Code，再拖入
.vsix文件 - 或临时关闭校验：
settings.json加一行"extensions.installVerification": false（验证完务必删掉） - 检查
.vsix解压后extension/package.json中的"engines.vscode"字段，确保与本地code --version主版本号兼容（如1.91.0→ 要写"^1.91.0"） - 重打包必须用
zip命令或 7-Zip，Windows 资源管理器双击解压再压缩会破坏 ZIP 结构
插件显示已安装但功能不工作
装上 ≠ 激活 ≠ 生效。尤其 Python 类插件，右下角看不到解释器选择、右键没有 Run Python File，大概率是环境错位或激活失败。
- 执行
code --list-extensions | grep python（macOS/Linux）或code --list-extensions | findstr python（Windows），只输出ms-python.python才算核心插件装对了 - 看左下角状态栏：出现
SSH: xxx、WSL: Ubuntu或Dev Container，就说明你正在远程上下文中——此时必须切换到 Local 窗口（File → Close Remote Connection），再重新安装 - 打开
Output面板，选Python或Extension Host日志源，找Extension activation failed类错误，常见于 Node.js 版本不匹配或调用了废弃 API（如vscode.workspace.rootPath）
真正卡住人的地方，往往不是“怎么装”，而是“装给谁用”——Local 窗口、Remote-SSH、WSL、Dev Container 四个环境各自维护一套插件，互不共享；还有人把 locale.json 放错路径、写错值，或者以为改了设置就生效，其实必须通过命令面板执行 Configure Display Language 并重启。这些细节不踩一遍，很难意识到问题不在市场，而在自己和 VS Code 的契约关系里。
