真正能用的.vsix文件应通过官方直链下载：插件页点击Download Extension，或用API拼URL（含准确publisher、extension_name和version）；离线安装需加--allow-unverified参数，并确保VSCode已添加至PATH、关闭所有实例、路径无中文空格。
怎么下载到真正能用的 .vsix 文件
离线安装失败，八成是 .vsix 文件本身就有问题：签名失效、版本不匹配、或压根就不是官方源。别信第三方“一键打包站”，也别从 GitHub Release 页面随手点下载——很多开源插件的 Release 页没同步最新 .vsix，engines.vscode 字段可能还是旧的。
最稳做法是走官方直链：
- 打开插件页面，比如
https://marketplace.visualstudio.com/items?itemName=ms-python.python - 右侧 Resources 区域点 Download Extension —— 这个按钮生成的是带签名的临时直链，版本和签名都对得上
- 如果要批量或下旧版本，用 API 拼 URL：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher是ms-python，extension_name是python（小数点后半段），version必须和 Version History 里完全一致，比如2026.6.123456
浏览器访问该 URL 就直接下载；用 curl -L -o python.vsix 也能自动化获取。
code --install-extension 总是报错？先查这三件事
code --install-extension 看似简单，但报错信息极简，实际卡点很具体：
-
command not found: code→ 不是 PATH 问题，而是 VSCode 没启用 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 正在运行且已加载同名插件，先关掉所有 VSCode 实例再重试 - 路径含中文或空格（如
C:\用户\张三\下载\python.vsix）→ 移到纯英文路径，例如C:\vsix\python.vsix
装了插件但功能不生效？大概率缺依赖
VSCode 插件的依赖关系不是靠“推荐列表”决定的，而是硬编码在 .vsix 解压后的 package.json 的 extensionDependencies 字段里。比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化 Tailwind 类名就会静默失效。
批量部署时别靠人肉判断：
- 在已配好的联网机器上导出完整扩展列表：
code --list-extensions > extensions.txt - 逐行用
vsce download下载对应.vsix：vsce download ms-python.python@2026.6.123456 - 注意顺序：先装依赖项（如
ms-python.pylance），再装主插件（如ms-python.python）
别信插件页面写的 “Recommended”，那是编辑推荐，不是运行依赖。
装完插件，设置还是默认？配置文件没同步
.vsix 只负责代码逻辑，不带任何用户配置。你看到的 Python 解释器路径、Prettier 默认选项、语言包 locale，全存在本地配置文件里。
关键路径如下：
- 用户级设置：
%APPDATA%\Code\User\settings.json（Windows）、~/Library/Application Support/Code/User/settings.json（macOS）、~/.config/Code/User/settings.json（Linux） - 工作区级设置：
.vscode/settings.json（项目根目录，可 Git 管理） - 调试/任务配置：
.vscode/launch.json、.vscode/tasks.json，必须放在项目.vscode/目录下才生效
特别注意：settings.json 里如果写了 "locale": "en"，即使装了中文语言包也不会生效 —— 得手动删掉或改成 "zh-cn"。
