唯一正确下载方式是通过VS Code市场插件页右侧“Download Extension”按钮；其他途径下载的文件90%非标准.vsix或版本不匹配，需验证文件完整性、解压结构及依赖项。
能直接从 VS Code 市场下载 .vsix 文件，但必须用浏览器打开插件页点“Download Extension”，不能靠右键另存为或从 GitHub Releases 猜路径——后者大概率下错包。
怎么在有网机器上正确下载 .vsix 文件
VS Code 市场页面右侧的“Download Extension”按钮是唯一官方支持的离线包获取方式。其他途径（比如 GitHub Release 页面、第三方镜像、搜索引擎结果）下载的文件，90% 不是标准 .vsix 格式，或者版本不匹配。
- 打开
https://marketplace.visualstudio.com/vscode，搜索插件名（如ms-python.python） - 点击进入详情页，往右滚动到 “Resources” 栏，找到并点击
Download Extension - 浏览器会自动下载一个
xxx-1.2.3.vsix文件；建议立即重命名为带版本号的格式，例如python-2024.6.0.vsix - 别用右键“另存为”插件页本身，也别从插件仓库的
Releases里随便下.zip或.tar.gz——这些不是 VSCode 认可的安装包
下载后怎么验证 .vsix 是完好的
杀毒软件、Edge/Firefox 有时会把 .vsix 当作 zip 自动解压再改后缀，导致 ZIP 头损坏，VSCode 拖进去静默失败，也不报错。
- macOS/Linux：运行
unzip -t your-plugin.vsix，输出含OK才算完整 - Windows PowerShell：用
Get-ChildItem your-plugin.vsix | ForEach-Object { $_.Length }确认文件大小 > 100KB（极小的包基本不可信），再用Expand-Archive尝试解压看是否报错 - 解压后检查根目录是否有
extension/package.json，打开它确认"engines": {"vscode": "^1.85.0"}中的版本 ≤ 你内网机器的code --version主版本（如 1.85.2 → 取 1.85）
怎么批量导出已装插件列表并下载对应 .vsix
如果你有一台配好环境的开发机，想把整套插件迁移到内网，别手动一个个搜，用 CLI 导出 ID 列表，再脚本化下载。
- 在源机器执行：
code --list-extensions > vscode-extensions.txt，生成类似ms-python.python、esbenp.prettier-vscode的纯文本列表 - 写个简单脚本（PowerShell 或 Bash），对每行 ID 拼接市场 URL：
https://marketplace.visualstudio.com/items?itemName=ms-python.python，再模拟点击“Download Extension”逻辑（可用curl -L -o+ 解析 HTML，但更稳的是用现成工具如vsce或 Python 的requests+ 正则提取下载链接） - 注意：有些插件（如
ms-dotnettools.csharp）依赖私有 CDN，公开市场页可能不显示下载按钮——这类得提前在源机器上启动一次，让插件自动拉取语言服务器，然后整目录打包迁移
为什么装好了插件却没反应？关键盲区在这儿
离线安装最常被忽略的不是“装没装上”，而是“能不能用”。VSCode 显示已安装 ≠ 插件已激活 ≠ 功能就绪。
- 首次启用时弹权限提示（如访问终端、读取文件），若用户没点“允许”，插件会保持禁用状态，扩展面板里显示灰色“禁用”字样
- 某些插件（如
ms-python.python）会在打开.py文件时才触发语言服务器下载——离线环境下这个步骤卡住，状态栏一直转圈，输出面板（View → Output → Python）里能看到Failed to fetch - 插件依赖的 native 二进制（如
pyright、prettierCLI）不会随 .vsix 一起打包，必须提前在有网机器上运行过该插件，让它下完，再把整个%USERPROFILE%\.vscode\extensions\ms-python.python-xxx\目录拷过去
真正可靠的离线部署，从来不是只传一个 .vsix 文件，而是版本、结构、依赖、路径四者全部对齐——少验一项，就可能花半小时排查“明明装了却不生效”。
