vs code插件安装卡在“installing…”通常是解压或校验阻塞,而非网络慢;应彻底退出进程、清理.extensions-tmp目录、检查权限与签名校验,并确认扩展市场源及engines.vscode兼容性。

卡在“Installing…”不是网络慢,是扩展系统卡在解压或校验环节
VS Code 显示“Installing…”但进度不动,90% 情况下根本没在下载,而是在解压 .vsix 或校验签名时被阻塞。它不报错、不超时、也不重试,只干等——你看到的“99%”其实是写入 .extensions-tmp 目录失败,常见于杀软拦截、权限错乱或进程残留占用。
先彻底退出 VS Code:Windows 查 Code.exe 和 Code Helper.exe 进程;macOS 用活动监视器搜 Code;Linux 执行 ps aux | grep code。确认无残留后,删掉临时目录:
- Windows:
%USERPROFILE%\.vscode\.extensions-tmp - macOS/Linux:
~/.vscode/.extensions-tmp
删完再启动,别急着装插件——先打开命令面板(Ctrl+Shift+P),输入 Extensions: Show Installed Extensions 看是否能正常列出已装插件。如果空白或报错,说明扩展宿主已崩,必须用 code --disable-extensions 启动后再逐个启用。
VS Code 1.85+ 默认连 open-vsx.org,国内常解析失败或静默 fallback 到停用地址
VS Code 自 1.85 起把默认扩展市场从 marketplace.visualstudio.com 切到 open-vsx.org,但国内 DNS 经常解析失败,或 fallback 机制触发后连上已停用的旧地址,最终表现为“找不到插件”或请求一直 pending。
最快验证方式:按 Ctrl+Shift+P → Developer: Toggle Developer Tools → 切到 Network 标签页 → 点一次安装,看请求发往哪个域名、状态是否为 pending 或 failed。若看到大量 open-vsx.org 请求失败,就该换源了。
推荐使用阿里云镜像(稳定、无需代理):在 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"
改完保存,**必须完全重启 VS Code**,否则设置不生效。
手动安装 .vsix 却提示 Failed to install extension 或 Unable to load extension
拖入 .vsix 文件失败,通常不是文件损坏,而是 VS Code 仍尝试联网校验签名——哪怕你断网拖进来了,它也会先发请求,失败后才退到本地加载,而这个过程可能被跳过或中断。
可靠做法只有两个:
- 断网后启动 VS Code,再拖入
.vsix(最稳) - 提前关校验:
"extensions.installVerification": false(仅调试用,验证完务必删掉)
另外务必检查 .vsix 解压后的 package.json 中 engines.vscode 字段。例如你用的是 1.90.0,插件写 "^1.85.0" 没问题;但如果写 "^1.92.0",VS Code 就会直接拒绝加载,不给任何提示。
权限问题也高频出现:
- macOS/Linux:运行
ls -ld ~/.vscode/extensions,确保 owner 是当前用户,不是root;曾用sudo code启动过?修复命令:sudo chown -R $USER:$GROUPS ~/.vscode - Windows:避免路径含中文或空格(如
C:\Users\张三或C:\Program Files),否则参数解析失败会导致静默中断
Python / Volar 等插件装完不生效,不是没装上,是激活链路断了
安装成功 ≠ 功能可用。比如 ms-python.python 装完后没语法提示,大概率是 Pylance 激活失败,或 python.defaultInterpreterPath 没设对;Volar 提示 “not compatible”,往往只是 engines.vscode 写得太窄,而非真不支持。
打开一个 .py 文件,然后看 Output 面板(Ctrl+Shift+U)→ 切到 Python 或 Volar 日志,找 Extension activation failed 或 Cannot find module 类错误。常见原因:
- 插件依赖全局 CLI 工具(如
eslint、prettier),但没装:npm install -g eslint - VS Code 内置 Node 版本与插件编译目标不一致(尤其含原生模块的插件,如
@volar/xxx) - 工作区启用了
extensions.ignoreRecommendations,却忘了关
真正麻烦的从来不是“装不上”,而是装上了却没有任何报错,只默默不干活——这种静默失效最难排查,得靠 Output 面板日志和逐个禁用扩展来定位。











