离线安装VSCode插件关键在“装完能否用”：必须满足系统焦点、未解压vsix文件、VSCode版本≥插件要求，且语言服务器需在有网机触发后完整拷贝目录，ARM Mac须匹配darwin-arm64架构。
离线安装 VSCode 插件在局域网环境里不是“能不能装”的问题，而是“装完能不能用”的问题。绝大多数失败不是因为文件没复制过去，而是语言服务器、依赖插件或架构不匹配这些隐藏环节被跳过了。
拖.vsxx进VSCode没反应？先盯住三个运行态条件
这不是插件坏了，是 VSCode 根本没收到拖放信号。高频静默失败原因只有三个：
- VSCode 没获得系统焦点：任务栏图标未高亮，鼠标悬停无响应——点一下编辑区空白处再试
- 当前处于全屏模式或远程桌面（RDP / TeamViewer）：这类环境会拦截 drag event，必须退出全屏或改用命令行
- 拖的是解压后的文件夹、重命名过的
.zip，或顶层不含extension/目录的包：用unzip -l xxx.vsix确认输出第一行是extension/
code --install-extension 命令总失败？路径和签名是卡点
这个命令容错率极低，报错往往只有一行，但根源很明确：
- 必须用绝对路径：
code --install-extension /home/user/ext/ms-python.python-2024.6.0.vsix（Linux/macOS），Windows 推荐正斜杠写法：code --install-extension C:/ext/prettier-9.10.3.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "/mnt/backup/my ext.vsix" - 报
INVALID_SIGNATURE？离线环境无法校验证书链，加--allow-unverified参数：code --install-extension python.vsix --allow-unverified -
command not found: code？不是 PATH 问题，是 VSCode 没启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车
插件显示已安装，但 Python 补全/格式化不生效？LSP 没落地
VSCode 安装 .vsix 只是注册前端代码，像 ms-python.python、volarjs.volar 这类插件首次启用时，会动态下载 pyright-server 或 volar-server 二进制包——离线环境下就卡在 “Downloading…” 状态栏不动。
- 验证方法：打开一个
.py文件，看状态栏是否卡住；或打开View → Output→ 切换到Python面板，查Failed to fetch或spawn ENOENT - 正确做法：在有网机器上，用同版本、同架构（x64/arm64）的 VSCode 打开一次对应文件，等状态栏变绿（Ready），再把整个
~/.vscode/extensions/ms-python.python-2024.6.0/目录完整拷到内网机对应路径下 - 复制完必须彻底退出 VSCode：包括右下角托盘进程，否则缓存不刷新
ARM Mac 装 x64 插件失败？架构不匹配不报错，只丢功能
VSCode 不会提示“架构错误”，而是静默跳过 native 部分加载，导致补全、跳转、诊断全部失效。
- 检查方法：运行
code --version，看 Help → About 显示的架构（x64/arm64）；再查.vsix解压后package.json是否有darwin-arm64构建标识 - ARM Mac 必须用带
darwin-arm64的.vsix，尤其含 LSP server 的插件（如 Volar、Pylance） - 从 GitHub Release 页面下载时，别只认版本号，得盯紧平台后缀；官方市场下载的
.vsix通常已做多平台打包，但第三方发布页未必
真正难的从来不是把文件拷过去，而是搞清哪个插件需要提前触发下载、哪个依赖藏在 extensionDependencies 字段里、哪段二进制必须连同目录一起搬——这些细节不手动验证，光靠“装上了”三个字，等于没装。
