插件市场依赖安装失败90%非插件问题，而是VS Code扩展系统崩溃、网络无法直连marketplace或本地缓存/权限错乱；须先确认Extensions: Show Installed Extensions是否响应，再查网络连通性、清理.incomplete残留、换国内镜像源、验证环境上下文及激活日志。
插件市场依赖安装失败，90% 不是插件写得有问题，而是 VS Code 在下载、校验或解压依赖时卡在了网络、缓存或权限环节——它根本没走到“装不上”的阶段，而是连第一步都卡死了。
Extensions: Show Installed Extensions 打不开就别试安装
这是最常被跳过的起点：你点“Install”没反应，其实不是 Marketplace 挂了，而是扩展系统本身已瘫痪。命令面板输入 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)；Linuxkillall code - 重启时加
--disable-extensions参数启动：code --disable-extensions，再逐个启用 Python、Pylance 等关键插件，定位是否某个插件拖垮了 host - 检查
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下是否有残留的.incomplete文件夹，直接删掉
Failed to fetch 或卡在 “Installing…” 的真实原因
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"
离线环境或权限问题导致 EACCES / EPERM
这在 macOS/Linux 是权限错位，在 Windows 是路径解析失败的典型表现，和网络无关。
- macOS/Linux：检查
~/.vscode/extensions/所有者是否为当前用户，执行ls -ld ~/.vscode/extensions；若属主是root，运行sudo chown -R $USER:$GROUPS ~/.vscode/extensions - Windows：避免用户目录含中文（如
C:\Users\张三）或空格（如C:\Program Files\），VS Code 启动时会把路径传给 Node.js 子进程，未转义就直接崩 - 所有平台：删掉
~/.vscode/.extensions-tmp（Linux/macOS）或%USERPROFILE%\.vscode\.extensions-tmp（Windows），这个临时解压目录被杀软拦截后，VS Code 不报错，只干等
真正难搞的不是“装不上”，而是它根本不告诉你卡在哪一层——扩展视图打不开、网络请求静默失败、.vsix 被签名校验拦住、临时目录权限不对……这些环节全在后台无声发生，必须一层层切进去看。
