VSCode插件离线安装失败主因是.vsix与内核不匹配：版本号不符、engines.vscode字段过严或远端vscode-server架构不一致；须通过Marketplace官方直链下载签名版.vsix，命令行安装需加--allow-unverified参数并确保code已加入PATH、路径纯英文且无运行中进程。
VSCode 插件离线安装失败，八成不是“装错了”，而是 .vsix 文件本身和你的 VSCode 内核不匹配——版本号对不上、engines.vscode 字段太严、甚至远端 vscode-server 架构不一致，都会导致插件图标灰掉、功能静默失效。
怎么拿到真正兼容你内核的 .vsix 文件
别点 GitHub Release 页面随便下的 .vsix，很多没同步 Marketplace 签名或已过期。最稳路径是走官方直链：
- 打开插件市场页，比如
https://marketplace.visualstudio.com/items?itemName=ms-python.python - 点右侧 Resources → Download Extension，浏览器直接下载带签名的最新版
.vsix - 要下旧版本？去同页面点 Version History，抄下精确版本号（如
2023.14.0），拼 URL：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2023.14.0/vspackage - 注意 publisher 和 extension 名必须拆对：
ms-python.python中ms-python是 publisher，python是 extension，大小写、连字符一个都不能错
code --install-extension 报错的三个硬卡点
命令行安装看似一行搞定，但实际失败往往无声无息：
-
command not found: code→ 不是没装 VSCode，而是没执行Shell Command: Install 'code' command in PATH（Ctrl+Shift+P 搜这句） -
INVALID_SIGNATURE→ 离线环境无法校验证书链，必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完
code --list-extensions不显示 → 说明 VSCode 进程还在运行，关掉所有实例再试；路径含中文或空格（如C:\用户\张三\ext\）也会导致静默失败，务必用纯英文路径
为什么改了 package.json 还不生效
手动解压 .vsix、改 package.json 里的 "engines": {"vscode": ">=1.75.0"} 很常见，但容易漏关键一步：
- 改完
package.json后，必须用zip重新打包整个文件夹（不能只替换原.vsix里的某文件） - 重打包后把后缀从
.zip改回.vsix，否则 VSCode 会拒绝识别 - Remote-SSH 类插件还依赖远端
vscode-server版本，单改前端.vsix没用；得确认远端~/.vscode-server/bin/下的 commit ID 是否匹配该插件要求
真正容易被忽略的是：VSCode 对 engines.vscode 的校验发生在插件加载阶段，不是安装时——所以即使装成功了，启动后发现不工作，大概率是这个字段锁死了最低版本，而你本地版本刚好卡在边界上。
