vscode官方市场不支持插件版本选择，必须通过离线方式安装指定版本：浏览器点击“download extension”获取签名直链最可靠；手动拼api下载需严格匹配publisher、extension_name和version；github releases的.vsix可能未同步或engines字段过旧，下载后须解压校验package.json中的vscode兼容声明。
VSCode 官方市场不提供插件版本选择功能，所有“装指定版本”操作都必须绕过图形界面，走离线路径——这不是你操作不对，而是平台设计如此。
怎么下载到真正能用的 .vsix 文件
浏览器里点“Download Extension”按钮最稳，它生成的是带签名、时效短、版本准确的直链；别信 GitHub Releases 页面随手点的 .vsix，很多开源插件的 Release 没同步最新包，engines.vscode 字段可能还锁在旧版。
- 手动拼 API 下载（适合批量或旧版本）：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher和extension_name必须和插件 ID 完全一致（如ms-python.python→publisher=ms-python,extension_name=python），version必须和 Version History 里显示的一模一样（如2026.6.123456） - 下载后建议立即校验完整性：
unzip -t python.vsix（Linux/macOS），Windows 请用 PowerShell 执行Copy-Item "old.zip" "new.vsix" -Force而非重命名，否则文件头损坏会导致静默安装失败 - 下载完先解压看看：
unzip -p python.vsix extension/package.json | grep engines，确认"vscode": ">=1.75.0"这类声明是否覆盖你当前 VSCode 版本
code --install-extension 报错时优先查这三件事
命令行报错信息极简，但卡点非常具体，90% 的失败都出在这三处。
-
command not found: code→ 不是 PATH 问题，而是 Shell Command 没启用：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 -
INVALID_SIGNATURE→ 离线环境无法校验证书链，必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完不显示、
code --list-extensions无反应 → VSCode 正在运行且已加载同名插件，必须彻底退出（包括托盘进程），再重试 - 路径含中文或空格（如
C:\用户\张三\python.vsix）→ 移到纯英文路径，Windows 下命令中路径需用双引号包裹，推荐正斜杠：code --install-extension "C:/ext/python.vsix"
装上了但插件不工作？重点检查依赖和 native 组件
很多插件（尤其是 Python、Prettier、Rust）只是注册了前端逻辑，首次启用时才会拉取语言服务器（LSP）或 CLI 工具（如 pyright、prettier、rust-analyzer）。这些组件默认走外网，离线环境下会卡在状态栏“Downloading…”或输出面板报 spawn ENOENT。
- 正确做法：在有网机器上，用**完全相同版本的 VSCode** 安装插件 → 打开一个项目触发一次完整初始化 → 插件会自动下载并缓存 LSP 到
%USERPROFILE%\.vscode\extensions\ms-python.pylance-xxx\dist或类似路径 → 把整个扩展文件夹打包带走 - 像
ms-python.python这类壳插件，实际依赖ms-python.pylance和ms-python.vscode-pylance，package.json中的extensionDependencies字段写死了硬依赖，漏装一个，语法高亮或跳转就静默失效 - Remote-SSH 类插件更复杂：不仅前端要匹配，远端
vscode-server版本也得一致，单改本地.vsix没用
手动改 package.json 后必须重打包才生效
直接修改 .vsix 内部的 extension/package.json 不起作用——VSCode 安装时读的是 ZIP 包结构，不是解压后的临时文件。
- 正确流程：用
unzip python.vsix -d python-unpacked解压 → 编辑python-unpacked/extension/package.json中的"engines": {"vscode": ">=1.75.0"}行 → 保存后重新打包：zip -r python-fixed.vsix python-unpacked/→ 将后缀名从.zip改为.vsix - 改
engines.vscode时别写死"=1.85.0"，容易引发后续更新冲突；宽松写法如">=1.75.0"更稳妥 - 改完不生效？大概率是没重打包，或者没彻底退出 VSCode 导致缓存未刷新
真正容易被忽略的是：VSCode 启动时只扫描 extensions/ 目录下的子文件夹，每个文件夹名必须是 publishername.extensionname-version 格式；把 .vsix 文件直接扔进去是无效的。另外，所有“兼容性修复”都建立在主版本号一致的前提下——VSCode 1.90.x 装标称支持 ^1.87.0 的插件，仍可能因底层 API 变更而静默失败。
