离线安装失败主因是vscode静默校验、路径解析或版本匹配失败；code命令不可用需先运行shell command注册；拖拽无效需确认焦点、文件完整性及架构匹配；插件不生效常因语言服务器未离线部署。
离线安装失败，90% 不是插件坏了，而是 VSCode 在静默校验、路径解析或版本匹配环节卡住了——它不报错，只“假装装上了”或者直接不动。
code --install-extension 命令没反应或报 command not found
这不是网络问题，是 CLI 工具根本没注册进系统。VSCode 官方 .deb/.rpm 包和 macOS ZIP 版默认不自动配置 code 命令。
- 先运行
which code：无输出就说明命令不可见 - 临时解决：用绝对路径，如
/usr/bin/code --install-extension /path/to/xxx.vsix（Linux）或/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/xxx.vsix（macOS） - 永久修复：在 VSCode 里按
Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行，再重启终端 - 别加
sudo：否则插件会装到 root 用户目录，普通用户启动 VSCode 后看不到
拖拽 .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”
这不是文件损坏，而是 VSCode 在加载阶段拒绝解析 package.json 或校验失败。最常被忽略的是版本声明不匹配。
- 运行
code --version，取前两位（如1.92.2→1.92） - 解压 .vsix：
unzip -p plugin.vsix extension/package.json | grep engines，看"vscode": "^1.85.0"这类字段 - 本地版本必须 ≥ 插件要求的最低版本；差一个小版本（如 1.92 vs ^1.93.0）就会静默拒绝
- ARM 架构机器（如 M-series Mac）不能装 x64 构建的 .vsix：Help → About 里看架构，再去 Marketplace 的 versionhistory 页面手动选对应平台旧版下载
- 别手动改
package.json并重打包：绕过签名后插件可能被禁用，或关键功能（如调试器加载）直接失效
插件显示已安装但 Python/Java/C++ 功能不生效
很多插件（如 ms-python.python、redhat.java、ms-vscode.cpptools）只是“壳”，真正的语言服务、调试器二进制需额外下载，离线时不会自动触发。
- 打开对应文件（如
.py），看 Output 面板（Ctrl+Shift+U）→ 选Python或C/C++日志，找Downloading或spawn ENOENT类错误 - 正确做法：在有网机器上完整触发一次下载（打开文件→等状态栏不再显示 “Downloading”）→ 复制整个扩展目录（如
~/.vscode/extensions/ms-python.python-2024.6.0/）到离线机对应路径 - Java Pack 这类“元包”不能单独装：
vscode-java-pack本身不含代码，必须手动凑齐redhat.java、vscjava.vscode-java-debug等子扩展，并按依赖顺序安装 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新目录不被识别
最容易被跳过的点是：以为装上 .vsix 就万事大吉，其实 VSCode 加载插件前会静默联网校验签名、publisher ID 和依赖清单——哪怕你断网拖进去了，它也会先发请求，失败后才退到本地逻辑，而这个“退路”在某些环境里会被跳过或中断。
