离线安装插件最稳妥方式是U盘中转.vsix文件；需先核对本地VSCode版本与插件engines.vscode字段兼容性，从Version History选匹配旧版下载并重命名，再通过图形界面或code --install-extension命令安装，最后重启VSCode、检查启用状态及依赖插件是否齐备。
离线安装插件最稳妥、最可控的方式就是用移动存储设备（U盘、移动硬盘）中转 .vsix 文件——它不依赖网络、不绕过 VSCode 安装机制、也不需要手动解压或修改目录结构。
怎么下载到 U 盘：必须确认版本兼容性
VSCode 插件的 .vsix 文件不是“下下来就能装”，关键看 engines.vscode 字段是否匹配你本地的 VSCode 版本。否则安装时会静默失败，或弹出“Extension is not compatible”提示但不报错。
- 在联网机器上，先运行
code --version，记下输出的第一段（如1.82.2） - 访问 https://www.php.cn/link/3d29fb5278af9da98e9e7c9d3c97b9e2 这类插件页，点击右侧 “Version History” —— 不要只点 “Download Extension”，那默认给最新版，很可能不兼容旧版 VSCode
- 选一个发布日期早于你 VSCode 版本发布时间的版本（比如 VSCode 是 1.79.2，就别选 2024 年 6 月后发布的插件包）
- 下载后把文件重命名为
python-1.79.0.vsix这类带版本号的名字，避免后续混淆
怎么装进离线机器：图形界面和命令行都得会
U 盘插进目标机器后，两种安装方式各有适用场景，别只依赖一种。
- 图形界面（适合单个、少量插件）：打开 VSCode → 点左侧扩展图标 → 右上角 “⋯” → “Install from VSIX…” → 从 U 盘路径选中
.vsix文件 → 确认安装。注意：不要在扩展搜索框里输名字再点 Install，那是在线安装，会卡住或报错 - 命令行（适合批量、脚本化）：确保
code命令可用（Windows 下推荐用 PowerShell，macOS/Linux 用终端），执行：code --install-extension E:\extensions\python-1.79.0.vsix
多个插件可写成循环：Get-ChildItem -Path E:\extensions -Filter *.vsix | ForEach-Object { code --install-extension $_.FullName } - 如果提示
command not found: code，说明 VSCode 没把 CLI 加入 PATH。Windows 可在 VSCode 窗口按Ctrl+Shift+P→ 输入 “Shell Command” → 选择 “Install 'code' command in PATH”；macOS/Linux 需手动运行菜单里的 “Shell Command: Install 'code' command in PATH”
装完发现插件没生效：常见但容易被忽略的三件事
安装成功 ≠ 插件立即可用。很多问题出在“以为装完了”就去写代码，结果语法高亮、调试器全不工作。
- 重启 VSCode：部分插件（尤其是语言服务类，如
ms-python.python或ms-vscode.cpptools）必须完全退出再启动才加载完整 - 检查启用状态：进入扩展面板 → 左侧切换到 “Installed” → 找到刚装的插件 → 看右上角是不是 “Enable” 而非 “Disable”。有些插件默认禁用，需手动点一下
- 验证是否真正加载：按
Ctrl+Shift+P→ 输入命令名（如Python: Select Interpreter），如果能搜出来，说明插件已注册；若提示 “command not found”，大概率是版本不兼容或未重启
最麻烦的不是装不上，而是装上了但功能残缺——比如 Python 插件装了却不能跳转定义，八成是它依赖的 Pylance 没一起装。离线环境下，每个插件的 extension/package.json 里的 extensionDependencies 字段必须人工查清、逐个下载，漏一个，核心功能就断链。
