离线安装vscode插件卡99%或提示“unable to load extension”，主因是临时解压目录被锁、缓存损坏或签名校验失败；必须彻底退出vscode后手动删除.extensions-tmp、cache、cacheddata及workspacestorage等路径，再校验locale.json格式并临时禁用签名验证（装完即删）。
离线安装 VSCode 插件卡在 99% 或提示 Unable to load extension，不是文件坏了，而是临时解压目录被锁死、缓存损坏或签名校验失败——必须手动清理特定路径，否则重试永远卡住。
为什么离线安装会卡在 99%
VSCode 显示“Installing…”走到 99% 时，实际已下载完成，正尝试解压 .vsix 到临时目录并写入磁盘。此时若发生以下任一情况，进度就静默挂起：
- 杀毒软件拦截写入
.extensions-tmp目录 -
Code Helper.exe进程未完全退出，持续占用临时文件句柄 - 权限不足（尤其在受控账户或企业策略下）
- 旧缓存与新插件版本不兼容，导致解压后校验失败
必须清理的三个核心路径
删错位置等于白忙；以下路径需在 VSCode 完全退出后操作（检查任务管理器无 Code.exe 和所有 Code Helper.exe 进程）：
-
%USERPROFILE%\.vscode\.extensions-tmp（Windows）：插件解压中止后残留的半成品文件夹，直接删除即可 -
%APPDATA%\Code\Cache和%APPDATA%\Code\CachedData：语言服务器快照和扩展运行时缓存，旧缓存会干扰新插件激活逻辑 -
%APPDATA%\Code\User\workspaceStorage：部分插件（如 Python、Rust）在此缓存项目级状态，残留会导致“扩展主机意外终止”
装完不生效？重点检查 locale.json 和签名验证
离线安装汉化包后仍是英文，大概率是 locale.json 写错值或 BOM 污染：
- 文件路径：
%APPDATA%\Code\User\locale.json - 内容必须严格为：
{"locale":"zh-hans"}（注意短横线、全小写，不能是zh-CN或zh） - 用 VS Code 或 Notepad++ 保存为 UTF-8 无 BOM 格式；记事本默认带 BOM，会导致 JSON 解析失败
- 若仍报
Unable to load extension，临时在settings.json加："extensions.installVerification": false，装完立即删掉
验证是否真清干净
清理后不要急着重装，先做两件事确认环境已重置：
- 启动 VSCode，打开命令面板（
Ctrl+Shift+P），运行Developer: Show Running Extensions—— 若列表为空，说明插件层已干净 - 终端执行
code --status，观察输出中user data dir路径下是否还有extensions子目录；若有，说明%USERPROFILE%\.vscode\extensions没删对位置
真正干净的标志是：首次启动后，扩展面板空、设置是默认值、右下角没有自动登录提示——任何“复现旧状态”的迹象，都意味着某个缓存路径漏删了。
