离线安装VSCode插件失败主因是环境变量（PATH、HOME、TEMP）不一致导致解压、校验或激活静默卡住；需验证which unzip/node、修正shell配置文件、确保路径纯ASCII可写，并用VSCode内置Node执行npm rebuild适配原生模块。
离线安装 VSCode 插件失败，八成不是 .vsix 文件坏了，而是环境变量在几个关键环节里“各认各的爹”——你手动拖进来的插件，被卡在解压、校验、激活任一关，根源都在 PATH、HOME 或临时目录路径没对上。
拖入 .vsix 后卡在 “Installing…” 且无报错
这是最典型的环境变量静默失效场景：VSCode 尝试调用系统工具（如 unzip、node）解压和校验插件，但找不到可执行文件。
- Linux/macOS：打开集成终端，运行
which unzip node；若返回空，说明 PATH 没生效——GUI 启动的 VSCode 不读~/.zshrc，必须把export PATH="/usr/bin:$PATH"写进~/.zprofile并完全退出 VSCode 重开 - Windows：检查是否在「系统变量」PATH 中添加了
C:\Windows\System32（expand.exe和certutil.exe在此），仅用户变量 PATH 不够 - 所有平台：禁用杀软临时目录拦截，删掉
~/.vscode/.extensions-tmp（macOS/Linux）或%USERPROFILE%\.vscode\.extensions-tmp（Windows）再试
安装成功但插件不激活（如 Python/Java 扩展灰掉）
插件已写入磁盘，但语言服务器或后台进程起不来，常见于 HOME 或 TEMP 路径含中文、空格或符号，导致 Node.js 子进程启动失败。
- macOS/Linux：检查
echo $HOME输出是否含中文或空格；若为/Users/张三，需新建标准英文用户名账户并迁移项目 - Windows：确认 VSCode 是从 PowerShell 或 CMD 启动（非快捷方式双击），否则
%USERPROFILE%可能解析为C:\Users\张三，Node.js 直接拒绝加载 - 统一验证法：在 VSCode 集成终端中运行
node -e "console.log(process.env.HOME, process.env.TEMP)"，输出路径必须是纯 ASCII 字符且可写
离线安装 CodeLLDB / C/C++ 等含原生模块插件失败
这类插件的 .vsix 包内嵌二进制（如 lldb-vscode），安装时需匹配当前 VSCode 内置 Electron 的 Node 版本和 NAPI 层级，而离线环境无法自动重建——环境变量冲突就体现在 process.versions.node 和构建目标不一致。
- 先查 VSCode 实际 Node 版本：在开发者工具控制台（
Ctrl+Shift+P→Developer: Toggle Developer Tools）中运行process.versions.node，2026 年 9 月主流是22.4.0 - 若你本地
node -v是20.15.0，别指望用它重编译；必须用 VSCode 自带的 Node（路径见process.execPath的父目录）执行npm rebuild - 关键参数不能少：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0（对应 Node 22.4 + Electron 34）
真正棘手的从来不是“怎么装”，而是“装完谁在跑、用哪套环境跑”。离线环境下，每一步都得亲手把 PATH、HOME、TEMP、NODE_OPTIONS 这些变量钉死到具体值，任何一处继承链断裂，插件就停在灰色状态不动——连日志都不报，只安静地等你去翻 ~/.vscode-server/data/logs 里的 timestamp 最新的那个文件。
