VSCode插件安装卡在99%的根源是.extensions-tmp目录被锁死或权限异常,导致解压后无法移入extensions/目录;需彻底退出VSCode、删除该临时目录及Cache、CachedData、extensionsCache等缓存,并检查插件兼容性与签名校验。

VSCode安装卡在99%时,.extensions-tmp是罪魁祸首
不是网络慢,也不是插件损坏,而是 VSCode 解压 .vsix 包时写入临时目录失败。这个过程卡在最后一步——把解压好的文件从 .extensions-tmp 移到 extensions/ 下,一旦该目录被占用或权限异常,进度条就永远停在 99%,且不报错、不超时、不重试。
- Windows 路径:
%USERPROFILE%\.vscode\.extensions-tmp - macOS/Linux 路径:
~/.vscode/.extensions-tmp - 必须完全退出 VSCode(任务管理器里杀光
Code.exe、Code Helper.exe或electron进程),否则目录被锁,删不掉或删了也无效 - 删完别急着启动——先确认目录已彻底消失,再开 VSCode,否则它会复用残留状态继续卡住
只清 .extensions-tmp 不够,Cache 和 CachedData 也要同步清理
.extensions-tmp 解决的是“安装卡住”,但装完图标不显示、插件列表空白、搜索无结果,大概率是元数据缓存没更新。VSCode 把插件市场返回的 JSON、图标 URL、分类快照分别存在两个地方:
-
Cache:存 HTTP 响应体(比如gallery.visualstudio.com的接口返回),影响加载速度和 CDN 图片 -
CachedData:存压缩过的扩展详情快照(含版本号、截图地址、分类标签),决定插件是否“可见” - 只清一个,会出现“能搜到但点不开”或“点了 Install 按钮变灰却没反应”
- 路径按系统区分:
Windows:%APPDATA%\Code\Cache和%APPDATA%\Code\CachedData
macOS:~/Library/Caches/com.microsoft.VSCode和~/Library/Application Support/Code/CachedData
Linux:~/.config/Code/Cache和~/.config/Code/CachedData
装完插件没图标?检查 extensionsCache 目录是否损坏
插件已出现在列表里、点击“Install”也成功,但侧边栏没图标、右键菜单没入口、甚至 Ctrl+Shift+X 打开 Extensions 视图是空的——这不是网络问题,是 extensionsCache 元数据损坏了。它不负责下载,只告诉 VSCode “有哪些插件可用”,一旦出错,整个 Marketplace 就成空壳。
- 路径位置:
Windows:%USERPROFILE%\.vscode\extensionsCache
macOS/Linux:~/.vscode/extensionsCache - 删完必须完全退出 VSCode 后重启,不能只 “Reload Window”——这个缓存是进程启动时一次性加载的
- 如果删了还不生效,进
~/.vscode/extensions看对应插件文件夹是否存在、有没有package.json和入口文件(如extension.js),缺一个就注册失败 - 留意带
-cache后缀的文件夹(如ms-python.python-2026.8.0-cache),这是更新中断留下的半成品,VSCode 会优先加载它并静默失败,直接删掉
离线安装 .vsix 失败?关网 + 关签名校验才稳
拖 .vsix 文件进 VSCode,弹出 “Unable to load extension”,不是文件坏了,而是 VSCode 默认仍尝试联网校验签名。哪怕你已断网,它也会先发请求,失败后才退到本地加载——而这个流程可能被跳过或中断。
- 最稳做法:拔网线 / 关 Wi-Fi → 完全退出 VSCode → 启动 → 拖
.vsix→ 安装 - 若仍失败,在
settings.json里加一行:"extensions.installVerification": false(仅调试用,验证完务必删掉) - 检查
.vsix解压后的package.json中engines.vscode字段,比如你 VSCode 是 1.90.2,插件写的是"^1.92.0",就真不兼容——需手动解压、改版本、重新打包 - 注意:用记事本保存
locale.json时别带 UTF-8 BOM,否则 JSON 解析失败,界面直接回退英文
真正卡住的地方从来不是“删不删”,而是删哪几个目录、按什么顺序删、删完要不要杀进程、杀完要不要关网——每个环节漏一步,缓存就清不干净,症状就换一种方式回来。


















