vscode离线安装插件失败主因是版本不匹配、文件损坏、依赖缺失或路径错误；需用unzip -t校验.vsix完整性，比对code --version与package.json中engines.vscode版本，离线部署lsp服务器并整目录迁移，且必须彻底退出vscode刷新缓存。
内网环境下 VSCode 插件离线安装失败，90% 不是操作步骤错，而是卡在版本不匹配、文件损坏、依赖缺失或路径没走对这四点上。直接拖拽 .vsix 或双击安装基本不可靠，必须用 code --install-extension 配合手动校验。
怎么确认 .vsix 文件本身能用
浏览器下载的 .vsix 经常被自动解压成 .zip，再手动改后缀会破坏 ZIP 头，VSCode 会静默跳过——不是报错，是根本没反应。
- Windows 下别右键重命名，用 PowerShell 执行：
Copy-Item "prettier.zip" "prettier.vsix" -Force - macOS/Linux 运行：
unzip -t prettier.vsix，输出OK才算完整 - 解压后检查顶层是否有
extension/package.json；若只看到一堆零散文件，说明已损坏或被解压过 - 用
unzip -p your.vsix extension/package.json | grep engines直接看"vscode": "^1.85.0"是否匹配你本地code --version输出（取前两位，如1.85.2 → 1.85）
为什么 code --install-extension 总报错
这个命令是离线部署唯一可靠入口，但它不帮你兜底环境问题。报错信息极简，实际卡点就三个：
-
command not found: code→ VSCode 没注册 CLI：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并回车执行 -
Extension is not compatible with Code→ 不是 VSCode 太旧，而是 .vsix 里package.json的engines.vscode要求 ≥ 1.85，你本地是 1.84.3 —— 必须手动比对 - Windows 路径含空格必须加双引号：
code --install-extension "D:\vsix\ms-python.python-2024.6.0.vsix"；Linux/macOS 必须用绝对路径，~/Downloads/xxx.vsix会失败
装上了但插件不工作？缺的是语言服务器（LSP）
很多插件（如 Python、Volar、Prettier）安装只是注册，首次启用才下载 LSP 二进制（pyright-server、volar-server、prettier CLI），离线环境会卡在状态栏 “Downloading…” 或 Output 报 spawn ENOENT。
- 正确做法：在有网机器上打开一个
.py或.vue文件，等状态栏不再显示下载，再整目录拷贝对应扩展文件夹（如%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0\） - 不能只拷
.vsix，也不能只拷node_modules；native 二进制藏在子目录（如out/server/pyright-node），漏一个就启动失败 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
中文语言包为什么装了还是英文
VSCode 自 1.70 起禁用双击或拖拽加载机制，仅复制文件不会注册扩展 ID，也不会触发语言资源加载流程。
- 必须通过
Ctrl+Shift+P→Extensions: Install from VSIX安装ms-ceintl.vscode-language-pack-zh-hans-*.vsix - 安装后手动创建或编辑
locale.json（路径：%USERPROFILE%\AppData\Roaming\Code\User\locale.json），内容严格为：{"locale":"zh-cn"}（小写、连字符、UTF-8 无 BOM） - 重启前杀掉所有
Code.exe进程（任务管理器里全结束），否则设置不生效 - 企业策略可能拦截
file://协议，此时需联系 IT 管理员放开白名单，或改用管理员权限运行 VSCode
真正难的不是“怎么装”，而是“怎么验证它真能用”——版本、结构、依赖、路径、进程、策略，五层校验缺一不可。尤其 LSP 和 locale 这类后台服务，不彻底重启 + 查 Output 面板日志，很容易以为装成功了。
