离线安装VSCode扩展完全可行且官方支持，关键在于确保.vsix版本匹配、依赖预下载、路径正确及彻底重启VSCode；拖拽失效多因无工作区或焦点问题，CLI安装需用绝对路径和引号，手动解压须严格保持目录结构。
离线安装 VSCode 扩展，只要 .vsix 文件来源可信、VSCode 版本匹配、路径和操作方式正确，就能成功——这不是权宜之计，而是 VSCode 官方支持的标准流程。失败几乎都卡在版本校验、依赖缺失或 GUI 条件未满足上。
拖拽 .vsix 到主窗口为什么没反应
这是内网部署中最常被误判为“安装失败”的场景，其实只是触发条件没到位：
- VSCode 必须已加载一个工作区（哪怕只打开一个空文件夹），空白启动页不响应拖放
- 窗口必须有系统焦点：任务栏图标未高亮、或多显示器缩放偏移时，拖拽坐标会失效
- 不能处于全屏状态，也不能在远程桌面（如 RDP/TeamViewer）或 SSH 远程连接未就绪时操作
- 拖的是原始未解压的
.vsix文件——它本质是 zip 包，用unzip -l xxx.vsix应能看到顶层为extension/目录；解压后拖文件夹无效 - 右下角状态栏若显示
Extensions disabled by policy，说明企业组策略已禁用所有扩展安装，拖拽和命令行都会静默失败
code --install-extension 命令总报错 Extension is not compatible with Code
这个错误 99% 是版本不兼容，不是网络问题。VSCode 会严格比对 .vsix 包内 package.json 的 "engines": {"vscode": "^1.85.0"} 字段与本地 code --version 输出的主版本号（如 1.90.2 → 取 1.90）。
- Windows 下路径含空格或中文，必须用英文双引号包裹：
code --install-extension "C:\vsix\ms-python.python-2024.6.0.vsix" - macOS/Linux 必须用绝对路径，相对路径（如
./ext.vsix）会失败：code --install-extension /home/user/ext/prettier-9.10.3.vsix - 若提示
command not found: code，说明 CLI 未注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 需要覆盖旧版时加
--force参数：code --install-extension xxx.vsix --force
插件列表显示“已安装”，但 Python 补全/格式化不生效
这是典型的“假成功”：安装流程走通了，但插件没激活，或关键依赖（如 pyright、prettier CLI）根本没下载。
- 语言类插件（如
ms-python.python、esbenp.prettier-vscode）首次启用时会自动拉取 LSP 服务或二进制工具，默认走外网，离线环境会卡在状态栏 “Downloading…” 或输出面板报Failed to fetch - 解决办法：提前在有网机器上完整启动一次该插件（打开 .py 文件 → 触发补全 → 等下载完成），然后把整个插件目录（如
ms-python.python-2024.6.0/）拷到离线机的~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows） - 不能只拷
.vsix文件，也不能只拷node_modules里的二进制——必须是解压后完整的子目录结构 - 复制完需彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新插件不会加载
手动解压 .vsix 放入 extensions 目录的硬核方案
当 GUI 和 CLI 都被策略封锁，或目标机无图形界面（如纯终端服务器）时，这是唯一可行路径，但容错率极低，每一步都必须精准。
- 先用
unzip -l xxx.vsix查看顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压命令示例：
unzip xxx.vsix -d /tmp/ext && mv /tmp/ext/ms-python.python-2024.6.0 ~/.vscode/extensions/ - Windows 下注意路径分隔符，且不能用资源管理器直接解压（可能丢权限或改名），建议用 PowerShell 的
Expand-Archive - 复制后目录结构必须是：
~/.vscode/extensions/ms-python.python-2024.6.0/package.json存在，且node_modules下有对应平台的二进制（如darwin-arm64或win32-x64） - 最后一步最容易被跳过：必须完全退出 VSCode（杀掉所有
Code Helper进程），再重新打开，否则扩展不会出现在列表里
最易被忽略的点是：离线环境里，“安装完成”不等于“可用”。很多插件要等你打开第一个 .py/.js 文件才真正初始化，而初始化过程又依赖提前下载好的 native 模块。没这一步，光看扩展列表是看不出问题的。
