插件更新卡在“installing…”是因.vscode/.extensions-tmp目录被锁死,需彻底退出vscode后删除该临时目录并清空缓存;同时正确配置国内镜像源(含末尾斜杠)并重启,或离线安装时关闭签名校验。

插件更新卡在“Installing…”不动?不是网络慢,是临时目录被锁死
VSCode 显示“Installing…”卡在 99%,实际是解压 .vsix 包时写入 .extensions-tmp 目录失败,不是下载没完,而是后续步骤卡住。这个临时目录用于存放解压中的插件包,一旦被杀毒软件拦截、权限不足或进程残留占用,VSCode 就静默挂起——不报错、不超时、不重试。
常见表现包括:
- Extensions: Install from VSIX 拖入后进度条走完但无反应
- 在线安装点“Install”后按钮变灰,右下角提示一直挂着
- 任务管理器里能看到
Code Helper进程 CPU 突增后停滞
Windows 路径:%USERPROFILE%\.vscode\.extensions-tmp
macOS/Linux 路径:~/.vscode/.extensions-tmp
删前务必确认 VSCode 已完全退出:
• Windows 查 Code.exe 和 Code Helper 进程
• macOS 用活动监视器搜 Code
• Linux 执行 ps aux | grep code
删完必须清空后再启动 VSCode,否则它会复用损坏的缓存继续卡住。
为什么改了镜像源还是卡?检查 settings.json 里的 URL 格式
用 vscode.cdn.azure.cn 替换官方 Marketplace 地址是最有效的国内方案,但配置错误会导致完全失效。
关键细节:
- 必须关闭所有 VSCode 进程后再编辑
settings.json - Windows 路径:
%APPDATA%\Code\User\settings.json
macOS 路径:~/Library/Application Support/Code/User/settings.json
Linux 路径:~/.config/Code/User/settings.json - 添加这两行(注意逗号分隔,末尾必须有
/):"extensions.gallery.serviceUrl":"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/","extensions.gallery.cacheUrl":"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers" - 别漏掉末尾斜杠,也别加多余空格或引号闭合错误
保存后彻底重启 VSCode,首次加载可能稍慢,但后续安装成功率接近 100%。
离线安装提示 “Unable to load extension”?关掉签名校验再试
手动拖 .vsix 文件进 VSCode 却弹出该错误,不是文件损坏,而是 VSCode 仍试图联网校验签名。哪怕你断网操作,它也会先发请求,失败后才退到本地加载——而这个流程可能被跳过或中断。
最稳做法:
- 拔网线 / 关 Wi-Fi → 启动 VSCode → 拖
.vsix文件 → 安装 - 若仍失败,在
settings.json里加一行:"extensions.installVerification": false(仅调试用,验证完务必删掉) - 检查
.vsix解压后的package.json中engines.vscode字段,比如你 VSCode 版本是1.90.2,但插件写的是"^1.92.0",就真不兼容——需解压修改后重新打包
反复卡住?优先清理带 -cache 后缀的扩展残余
某些插件(尤其是语言包类)更新失败后,会在 ~/.vscode/extensions/ 下留下半成品文件夹,名字像 ms-ceintl.v 或含 -cache 后缀,它们会干扰新安装流程。
建议操作:
- 进入对应路径,执行
ls -la ~/.vscode/extensions/ | grep -i cache(macOS/Linux)或dir %USERPROFILE%\.vscode\extensions | findstr cache(Windows) - 手动删除所有疑似残余的文件夹(如
ms-ceintl.vscode-language-pack-zh-hans-cache-1.90.0) - 同时删除
~/.vscode/extensionsCache目录(这是磁盘缓存索引,损坏后会导致插件元数据无法解析)
真正容易被忽略的是:这些缓存残留不会随“重载窗口”或“重启 VSCode”自动清理,必须手动定位并删干净。











