离线安装VSCode插件卡在“Installing…”或一闪消失，主因是签名校验、路径解析或版本匹配静默失败；code命令未注册需手动配置PATH；拖拽无效需确保窗口焦点、原始.vsix文件及架构匹配；LSP类插件还需离线部署server二进制。
离线安装 VSCode 插件卡在“Installing…”或进度条一闪就消失，基本不是插件坏了，而是 VSCode 在签名校验、路径解析或版本匹配环节静默放弃——它不报错，只不动。
code --install-extension 命令无反应或报 command not found
这说明 code CLI 工具根本没注册进系统 PATH，和网络无关。官方 .deb/.rpm/ZIP 包默认不自动配置。
- 先运行
which code：无输出即未注册 - 临时解决：用绝对路径，如
/usr/bin/code --install-extension /path/to/plugin.vsix（Linux）或/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/plugin.vsix（macOS） - 永久修复：VSCode 内按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车，再重启终端 - 别加
sudo：否则插件装到 root 目录，普通用户启动后不可见
拖拽 .vsix 到窗口后没反应或卡在 Installing…
图形界面安装依赖后台网络请求调度解压流程，断网时它不提示错误，只挂起或丢弃操作。
- 确认 VSCode 窗口有焦点：任务栏图标是否高亮？RDP/TeamViewer 下拖放常被拦截
- 检查文件是否真为原始
.vsix：用unzip -l plugin.vsix看顶层是否有extension/package.json；若显示一堆零散文件，说明已被解压或损坏 - 路径含中文或空格？Windows 必须用英文双引号包裹，如
"C:\my ext\ms-python.python-2024.6.0.vsix" - 虚拟机共享文件夹（如
/mnt/hgfs）拖入常失败：先复制到本地路径（如~/Downloads/），再拖
报 “Extension is corrupt” 或 “not compatible with the current version of VS Code”
这不是文件损坏，而是 package.json 中的 engines.vscode 字段与本地版本不匹配，VSCode 加载阶段直接拒绝解析。
- 运行
code --version，取前两位（如1.92.2→1.92） - 解压查看要求：
unzip -p plugin.vsix extension/package.json | grep engines，看类似"vscode": "^1.85.0"的字段 - 本地版本必须 ≥ 插件声明的最低版本；差一个小版本（如本地
1.92，插件要求^1.93.0）就会静默拒绝 - ARM 架构机器（如 M 系列 Mac）不能装 x64 构建的
.vsix：Help → About 里看架构，去 Marketplaceversionhistory页面手动选对应平台旧版下载
装完不生效，或中文包仍显示英文
语言类插件、LSP 类插件（如 Python、Go）离线安装后常“存在但不工作”，因为它们依赖额外二进制或运行时初始化，而这些步骤在断网时不会触发。
- 带 LSP 的插件（如
ms-python.python）需一并部署 server 二进制：离线环境建议从官网下载完整版.vsix，或手动补全out/server目录 - 中文包必须用官方 ID：
MS-CEINTL.vscode-language-pack-zh-hans，第三方包在 1.85+ 后基本失效 - 装完必须彻底退出 VSCode：右下角托盘图标也要右键退出，否则缓存不刷新；双击快捷方式可能启动旧实例
- 检查
settings.json是否误写"locale": "zh-cn"—— 正确值是zh-hans；Windows 若开了 “Beta: Use Unicode UTF-8”，会跳过语言包加载
最常被忽略的是：VSCode 不会在离线状态下预触发语言服务器或加载 nls bundle，哪怕插件目录里文件齐全，它也不会主动拉起进程。这类插件必须在有网环境首次安装激活一次，再整目录迁移，否则永远“已安装但不运行”。
