离线安装VSCode插件必须绕过签名验证、处理依赖链并确保语言服务器落地，否则虽显示已安装但功能静默失效；需用官方直链下载.vsix、加--allow-unverified参数安装、在有网环境预触发LSP后整目录迁移，并彻底退出VSCode进程。
离线安装 VSCode 插件不是“拖进去就完事”，而是必须绕过签名验证、处理依赖链、并确保语言服务器落地——否则插件列表里显示已安装，但状态栏不出现 Python 图标、格式化不生效、调试器打不开，全是静默失败。
拖.vsix进VSCode没反应？先检查这三件事
这不是插件坏了，是 VSCode 根本没收到安装信号。常见现象：松手后右下角无提示、无弹窗、编辑器区域无高亮反馈。
- VSCode 必须已加载工作区：至少打开一个文件或文件夹，空窗口（Welcome 页面）不接受拖放
- 拖入目标必须是主编辑器区域：不能拖进侧边栏、设置页、扩展面板本身，也不能拖到标题栏或菜单栏
- VSCode 必须有系统焦点且未被拦截：任务栏图标需高亮；全屏模式、RDP/TeamViewer 远程桌面、或企业组策略禁用扩展（右下角提示
Extensions disabled by policy）都会导致拖放失效
code --install-extension 命令总失败？路径和参数是硬门槛
这个命令不联网，只读取本地文件并写入 ~/.vscode/extensions/，但容错极低，报错时往往只吐一行模糊信息。
- 必须用绝对路径：
code --install-extension ./python.vsix会失败，得写成code --install-extension "C:/vsix/python.vsix"（Windows 推荐正斜杠） - 路径含空格或中文必须加英文双引号，否则静默失败
-
command not found: code？不是 PATH 问题，是 VSCode 没启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 报
INVALID_SIGNATURE？离线环境无法连微软证书服务器，必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified
装上了却没功能？语言服务器根本没下载
很多插件（如 ms-python.python、volarjs.volar、esbenp.prettier-vscode）的 .vsix 只是前端壳，首次启用才触发 LSP 服务（pyright-server、volar-server）下载。离线环境卡在 Downloading... 就是这个原因。
- 正确做法：在有网机器上，用同一版本 VSCode 安装该插件 → 打开一个对应类型文件（如
.py）→ 等状态栏显示Ready→ 拷贝整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0/）到内网机对应路径 - 拷贝完必须彻底退出 VSCode：包括右下角托盘进程，否则缓存不刷新，新目录不生效
- ARM Mac 装 x64 插件不会报错，只会静默跳过 native 二进制加载——运行
code --version查架构，解压 .vsix 后搜darwin-判断平台兼容性
批量部署时漏掉依赖？别信“推荐列表”
装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化直接失效；装了 ms-python.python 却没装 ms-python.pylance，类型提示全黑——这些坑都源于忽略 extensionDependencies。
- 真实依赖藏在 .vsix 解压后的
package.json里，不是插件市场页面写的“Recommended” - 最稳方式：在已配好的联网机器上导出全量清单：
code --list-extensions > extensions.txt，再逐个用vsce download下载：vsce download ms-python.python@2024.6.0 - 校验
engines.vscode字段：比如写的是"^1.85.0"，而你本地是1.84.2，装了也白装
最容易被忽略的点是：插件目录拷贝后不杀干净后台进程，以及语言服务器没在有网机上真正跑通一次就迁移——这两步一漏，所有操作都只是在列表里打勾，功能永远起不来。
