VSCode扩展安装卡在99%并非网络慢,而是解压.vsix时写入.extensions-tmp临时目录失败,常见于杀软拦截、权限不足或进程残留占用,需彻底退出VSCode后删除该目录并清空缓存方可解决。

为什么卡在99%不是网络慢,而是临时目录被锁死
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,否则它会复用损坏的缓存继续卡住
装完不生效?检查locale.json是否写错值
中文包装完却还是英文界面,大概率是locale.json里填了"zh-CN"或"zh"这类旧写法或非标准值。VSCode 1.85+只认"zh-hans"(注意是短横线,不是下划线,且全小写)。
这个文件位置固定:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/.vscode/locale.json
Linux:~/.vscode/locale.json
- 如果文件不存在,手动新建一个,内容仅一行:
{"locale":"zh-hans"} - 改完必须完全退出VSCode(关掉所有窗口 + 托盘图标右键退出),不能只“重载窗口”
- 别用记事本保存为UTF-8 BOM格式——BOM会导致JSON解析失败,界面直接回退英文
离线安装后提示“Unable to load extension”?断网+关签名校验
手动拖.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",就真不兼容——需解压修改后重新打包
反复卡住?优先清理带-cache后缀的扩展残余
某些插件(尤其是语言包类)更新失败后,会在~/.vscode/extensions/下留下半成品文件夹,名字像ms-ceintl.vscode-language-pack-zh-hans-1.90.2-cache。VSCode启动时会尝试加载它们,结果就是卡在“正在加载扩展”不动。
- 只删这些带
-cache后缀的子目录,别碰正常命名的扩展文件夹(如ms-ceintl.vscode-language-pack-zh-hans-1.90.2) - Windows用户注意:
%USERPROFILE%\.vscode\extensions\是主目录,%APPDATA%\Code\Extensions只是启用清单,删后者无效 - 删完重启前,顺手清一下
Cache目录(Windows:%APPDATA%\Code\Cache),避免渲染快照干扰


















