唯一可靠方式是打开官方市场链接如https://marketplace.visualstudio.com/items?itemName=ms-python.python，在右侧Resources区点击“Download Extension”按钮获取带时效签名的.vsix直链，确保版本、签名与完整性一致；第三方来源易导致404、旧版或签名失效。
怎么下载到真正能用的 .vsix 文件
直接点插件页的“Download Extension”按钮，才是唯一可靠方式。第三方镜像、GitHub Release 页面、甚至搜索引擎搜出来的链接，都可能返回 404、旧版本或签名失效的包。
关键动作是：打开 https://marketplace.visualstudio.com/items?itemName=ms-python.python 这类带 itemName 参数的官方链接，在右侧 Resources 区域点那个按钮——它生成的是带时效签名的直链，能确保版本、签名、完整性三者一致。
常见错误现象：
- 下载后
code --install-extension xxx.vsix报INVALID_SIGNATURE - 拖进 VSCode 没反应，但文件大小正常（其实是签名过期或非官方源）
- 装完插件图标显示已启用，但打开
.py文件时状态栏卡在 “Starting Python Server…”
此时别急着重下，先确认下载来源是否为官方市场详情页右上角按钮。
code --install-extension 命令为什么总失败
这个命令看似简单，实际对路径、环境、权限极其敏感，失败时往往不报具体原因，只静默退出或报错一行。
必须满足以下全部条件：
-
code命令必须可用：在 VSCode 中按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行（Windows/macOS/Linux 都适用） - 路径必须是绝对路径，且含空格或中文时要用英文双引号包裹：
code --install-extension "/path/to/Python-2024.6.0.vsix" - Windows 上推荐用正斜杠写法：
code --install-extension C:/ext/ms-python.python-2024.6.0.vsix（反斜杠易被转义） - 离线环境需加
--allow-unverified绕过证书链验证：code --install-extension python.vsix --allow-unverified
不满足任一条件，都会导致“看起来执行了，但插件没装上”的假成功现象。
装上了却没功能？LSP 服务根本没落地
很多核心插件（如 ms-python.python、volarjs.volar、esbenp.prettier-vscode）只装 .vsix 是不够的——它们前端注册成功了，但语言服务器（LSP）二进制文件仍需首次启用时在线下载。
离线环境下，你会看到状态栏一直显示 “Downloading Pyright…” 或 “Initializing Prettier CLI…”，然后卡死。
正确做法是：
- 在一台联网、同架构（x64 / arm64）、同 VSCode 版本的机器上，完整触发一次：打开对应类型文件（
.py、.vue、.js），等状态栏显示 Ready - 找到对应扩展目录：
%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\（Windows）或$HOME/.vscode/extensions/ms-python.python-2024.6.0/（macOS/Linux） - 整个目录打包复制到内网机相同路径下（注意保留子目录结构和 native 二进制）
- 彻底退出 VSCode（包括托盘进程），再启动
漏掉这一步，90% 的“已安装但无提示/无格式化”问题都解决不了。
ARM Mac 装 x64 插件会静默失败
VSCode 不会报错，也不会弹提示，而是直接跳过加载 native 层——结果就是 Python 补全失效、Volar 不识别 <script setup>、Tailwind 类名不提示。
检查方法很直接：
- 运行
code --version，看 Help → About 里写的架构（x64还是arm64） - 解压
.vsix，查package.json里是否有"darwin-arm64"构建标识；没有就说明是 x64 版 - 尤其含 LSP server 的插件（如 Volar、Pylance），必须匹配架构，否则功能残缺
从 GitHub Release 下载时，别只盯着版本号，得盯紧平台后缀：volar-1.12.0-darwin-arm64.vsix 才是 ARM Mac 正确包。
