先杀光所有Code进程再删.extensions-tmp；VSCode离线安装卡99%主因是该临时解压目录被进程占用或杀软拦截，须彻底退出后清理.extensions-tmp、Cache、CachedData及extensionsCache，并校验版本兼容性与路径权限。
离线安装卡在99%？先杀光所有Code进程再删 .extensions-tmp
VSCode离线装插件卡在99%，不是.vsix坏了，而是解压中转目录被锁死。它不报错、不重试，只静默挂起。.extensions-tmp 是临时解压区，不是缓存，但一旦残留损坏包或被Code Helper.exe（Windows）/Code Helper (Renderer)（macOS/Linux）占用，后续所有安装都会复现问题。
必须彻底退出 VSCode 后操作：
- Windows：任务管理器 → 结束所有
Code.exe和Code Helper.exe进程（包括后台和托盘） - macOS：活动监视器 → 搜索
Code→ 强制退出全部相关进程；或终端运行killall -9 Code - Linux：终端执行
pkill -f "code"或killall code - 若用过 Remote-WSL：先在 VSCode 里按
Ctrl+Shift+P→ 输入Remote-WSL: Close Remote Connection，再终端运行wsl --shutdown
删完路径：
Windows：%USERPROFILE%\.vscode\.extensions-tmp
macOS/Linux：~/.vscode/.extensions-tmp
装完不生效？顺手清掉 Cache、CachedData 和 extensionsCache
只删 .extensions-tmp 不够——离线安装失败常连带污染多层缓存。VSCode 启动时会优先读取这些目录，加载旧快照或损坏元数据，导致插件灰显、图标不显示、甚至“已安装”却无功能。
这三个目录必须一起清：
-
Cache：HTTP 响应缓存（含市场接口 JSON、CDN 图片），路径见下文 -
CachedData：扩展元数据快照（含版本号、分类、截图 URL），决定 Marketplace 是否能列出插件 -
extensionsCache：插件可见性核心缓存，删它才能让 VSCode 重新扫描extensions目录
路径对照：
Windows：%APPDATA%\Code\Cache、%APPDATA%\Code\CachedData、%USERPROFILE%\.vscode\extensionsCache
macOS：~/Library/Caches/com.microsoft.VSCode、~/Library/Application Support/Code/CachedData、~/.vscode/extensionsCache
Linux：~/.cache/Code、~/.config/Code/CachedData、~/.vscode/extensionsCache
code --install-extension 报错？路径、签名、版本三者缺一不可
命令行安装不是“有文件就能跑”，VSCode 对环境极其敏感，报错信息又极简，实际卡点非常具体：
- 路径必须是绝对路径，相对路径一律失败；含空格或中文时，必须加英文双引号
- 离线环境无法校验微软证书链，必须加
--allow-unverified参数：code --install-extension /path/to/python.vsix --allow-unverified - VSCode 版本必须 ≥ 插件
package.json中"engines": {"vscode": "^1.75.0"}声明的最低版本；版本低了不会报错，只会静默跳过加载 -
code命令未加入 PATH 会报command not found：在 VSCode 里按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车启用
拖.vsix进窗口没反应？焦点、格式、架构三处最容易漏
拖放是最稳的离线安装方式，但失败率高，原因很具体：
- VSCode 必须有系统焦点（任务栏图标高亮），全屏或远程桌面（RDP/TeamViewer）会拦截拖放事件
- 拖入的必须是未解压的完整
.vsix文件，用unzip -l xxx.vsix确认顶层含extension/目录 - ARM Mac 装 x64 插件不会报错，但 native 部分（如 LSP server）直接丢弃；运行
code --version看 Help → About 里的架构，再查 .vsix 解压后package.json是否含darwin-arm64构建标识 - 安装后插件默认禁用，尤其带权限声明（如
"workspace"）的插件，需手动点「启用」或重启 VSCode
真正干净的标志不是“装上了”，而是首次启动后扩展面板为空、设置是默认值、右下角没有自动登录提示——任何“复现旧状态”的迹象，都意味着某个缓存路径漏删了。
