最稳方式是拖进主窗口；需VSCode运行、文件未解压、非全屏、有焦点、拖至主编辑区，安装后须手动启用或重启。
离线环境下给 VSCode 装 .vsix 文件，核心就一条：别指望扩展面板能联网，必须绕过 Marketplace，用本地文件直接注册。只要 .vsix 文件完整、路径写对、VSCode 版本匹配，装不上基本是操作细节卡住了——不是 VSCode 不支持离线，是你没触发它的本地安装逻辑。
拖拽到主窗口是最稳的离线安装方式
很多用户试了命令行失败、点“从 VSIX 安装”没反应，最后发现拖一个 .vsix 文件到编辑器中央区域（不是侧边栏、不是设置页）就能弹出确认框，成功率远高于其他方式。
- 必须拖的是原始
.vsix文件，不是解压后的文件夹，也不是.zip或双后缀（如python.vsix.zip） - VSCode 必须已加载工作区（哪怕只是空文件夹），纯启动页或远程连接未就绪时拖放事件会被忽略
- 窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP、TeamViewer 或多显示器缩放偏移状态
- 安装后插件默认禁用，需手动点「启用」或重启 VSCode 才生效
code --install-extension 命令静默失败的三大硬条件
这个命令不报错、不提示、不反馈，错一个条件就直接跳过——它不是“尽力而为”，而是“全有或全无”。
- 路径必须是绝对路径：
code --install-extension /home/user/ext/prettier-9.10.3.vsix（Linux/macOS），code --install-extension "C:/ext/python.vsix"（Windows，含空格或中文必须加英文双引号） - 离线环境无法校验微软签名链，必须加
--allow-unverified参数，否则卡在验证阶段不报错也不继续 -
code命令本身必须可用：终端运行which code（macOS/Linux）或where code（Windows）有输出；若无，先在 VSCode 中按Ctrl+Shift+P运行Shell Command: Install 'code' command in PATH
装上了但功能不工作？语言类插件缺 LSP 服务
像 ms-python.python、rust-lang.rust-analyzer 这类插件，.vsix 只是前端壳子，真正干活的 pyright-server 或 rust-analyzer 是首次启用时才下载的二进制服务——离线环境下它就卡在 “Downloading…” 或直接跳过。
- 正确做法：在有网机器上，用**相同版本** VSCode 安装该插件 → 打开一个对应文件（如
test.py）→ 等状态栏变绿 → 确认 Output 面板中 Python 通道无报错 → 再拷整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0/）到内网机同路径下 - 拷完必须彻底退出 VSCode（包括右下角托盘进程），再重启，否则缓存可能跳过加载
- ARM Mac 上装 x64 插件、VSCode 版本低于
package.json中"engines": {"vscode": "^1.85.0"}要求，都会静默失效，面板显示“已安装”但功能灰掉
vsix 文件从哪来？别拼错 URL 也别信第三方打包
下载环节出错，后面全白忙。最稳路径只有一条：官方市场页点「Download Extension」按钮，直接得最新版 .vsix。其他方式都带风险。
- 用
vsixget工具最省心：pipx install vsixget && vsixget --latest ms-python.python，它自动解析页面、选兼容版本、下载并重命名 - 手动拼 URL 容易错：格式是
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension}/{version}/vspackage，其中{publisher}和{extension}要从插件 ID 拆（如ms-python.python→ publisher=ms-python, extension=python），{version}必须去 Version History 页面抄，填错就 404 - 第三方打包的
.vsix常缺平台原生模块（如linux-arm64架构的二进制），跨平台拷过去会报Unsupported platform
离线安装最难的从来不是“怎么装”，而是“怎么确认它真能用”——尤其是 AI 插件，装完看到面板就以为通了，结果第一次请求模型直接 401 或超时。这时候得分开看：插件是否注册成功（查 extensions 目录结构）、LSP 是否落地（看 Output 面板）、API 通道是否配对（TaoToken 的 Base URL 和 Key 是否填进对应字段）。三者缺一不可，但每一步的失败现象几乎一样：功能灰着，没报错。
