静默安装失败主因是扩展系统卡死、网络不通或权限/缓存异常，需逐层排查：先确认Extensions界面是否崩溃，再检查网络连通性、禁用干扰项、清理残留文件、验证路径与权限，并查看Extension Host日志定位深层问题。
静默安装失败，90% 不是插件问题，而是 VS Code 扩展系统卡死、网络无法触达 marketplace 或本地权限/缓存状态错乱导致的。重试、重启窗口、清浏览器缓存都没用，必须按链路逐层排查。
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 执行pkill -f code - 终端启动时加
--disable-extensions：比如code --disable-extensions，再手动启用 Python、Pylance 等关键插件，确认是否某个插件拖垮 host - 检查
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下是否有名称含.incomplete的残留文件夹，直接删掉
安装卡在 “Installing…” 或控制台报 ERR 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 前，仍会尝试联网校验签名。哪怕你断网拖进来了，它也会先发请求；失败后才退到本地加载，而这个过程可能被跳过或中断。
- 必须先断网，再启动 VS Code，再拖入
.vsix文件（否则卡在 fetch 阶段） - 或提前关掉校验：在
settings.json中加"extensions.installVerification": false（仅调试用，验证完记得删） - 检查
.vsix解压后的package.json中engines.vscode字段，比如你用的是1.90.0，但插件写的是^1.92.0，就真不兼容；若写的是^1.85.0，则没问题 - 路径含空格或中文时，Windows 必须用双引号包裹路径，比如：
code --install-extension "D:\vsix\ms-python.python-2024.6.0.vsix"
extensions.installDir 被错误自定义
很多人为了“统一管理插件”，在 settings.json 里手动加了 extensions.installDir，但路径不存在、拼写错误或没写权限，会导致所有扩展安装静默失败（连错误提示都不完整）。
- 打开设置（
Ctrl+,），搜索extensions.installDir，如果该配置存在，先注释或删掉它 - 确认默认扩展目录可写：
ls -la ~/.vscode/extensions/（Linux/macOS）或dir %USERPROFILE%\.vscode\extensions（Windows）；若报Permission denied，运行sudo chown -R $USER:$GROUPS ~/.vscode - 不要把扩展目录设到系统保护路径（如
/usr/local或C:\Program Files），哪怕你用了管理员身份启动
真正难处理的，是那些不报错、不弹窗、只让进度条停在 0% 的情况——它背后可能是 DNS 解析失败、杀软拦截临时目录、甚至 VS Code 内置 Node.js 版本与插件原生模块不匹配。这类问题不会出现在错误日志第一行，得去 Output 面板选 Log (Extension Host) 逐行翻。
