离线安装插件卡99%或提示“unable to load extension”，主因是.extensions-tmp目录被进程占用、杀软拦截或权限异常导致解压写入失败；须彻底退出vscode所有进程后删除该目录及cache、gpucache、extensions下-cache子目录，并校验locale.json格式与编码。
离线安装插件卡在99%、提示“Unable to load extension”或装完不生效，八成不是.vsix文件坏了，而是临时缓存没清干净——尤其是 .extensions-tmp 目录被锁死或残留损坏包。
为什么离线安装总卡在99%？
VSCode显示进度条走完却不动，实际是解压.vsix时写入 .extensions-tmp 失败。这个目录不是下载缓存，而是解压中转站，一旦被杀软拦截、权限不足或进程残留占用，VSCode就静默挂起，不报错也不重试。
- Windows 路径：
%USERPROFILE%\.vscode\.extensions-tmp - macOS/Linux 路径：
~/.vscode/.extensions-tmp - 常见诱因：后台还有
Code Helper.exe或node.exe在跑，文件句柄没释放
删前必须彻底退出所有 VSCode 进程
不关干净，删了也白删——系统仍会把空间算在“已使用”里，且重启后可能复用损坏缓存继续卡住。
- Windows：任务管理器 → “详细信息”页 → 结束全部
Code.exe和Code Helper.exe - macOS：活动监视器 → 搜索
Code→ 强制退出所有相关进程 - Linux：终端执行
pkill -f "code"或killall code - 如果用过 Remote-WSL，先在 VSCode 里按
Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection，再终端运行wsl --shutdown
除了 .extensions-tmp，还要顺手清这些地方
离线安装失败常连带污染其他缓存层，只删临时目录不够彻底。
-
Cache和GPUCache（路径见下）：Chromium 渲染层缓存，长期不清理会导致插件界面加载异常，删完重启自动重建
Windows：%APPDATA%\Code\Cache、%APPDATA%\Code\GPUCache
macOS：~/Library/Caches/com.microsoft.VSCode
Linux：~/.cache/Code -
extensions下的*-cache子目录：比如ms-python.python-2024.8.0-cache，这是更新中断留下的半成品，VSCode 启动时会尝试加载它，结果就是插件灰显或报错 - 如果装的是汉化插件，检查
locale.json是否填了"zh-CN"——VSCode 1.85+ 只认"zh-hans"，且必须是纯 UTF-8（无 BOM）
真正占空间的大户往往不是 .extensions-tmp 本身（它通常就几 MB），而是它触发的连锁缓存污染。清理时别只盯着一个目录，重点是“关干净→删临时→清关联缓存→重启验证”，否则下次拖.vsix进来，大概率又卡在99%。
