离线安装python插件成功但卡在“downloading pylance”是因.vsix仅含外壳，未预置pyright等native二进制；必须同步下载ms-python.vscode-pylance、ms-python.debugpy等严格匹配版本的依赖.vsix，或在有网机器触发lsp下载后整目录迁移至离线机对应extensions路径。
离线安装 VSCode 的 Python 插件（ms-python.python）能成功，但只拖一个 .vsix 文件进去，90% 会卡在 “Downloading Pylance” 或右下角一直转圈——它不是装失败了，是根本没启动语言服务。
怎么下载真正能用的 .vsix 文件
别点“Download Extension”就完事，那个按钮在缓存页或第三方镜像上可能返回 HTML 或旧版。必须走带签名、带平台标识的官方直链：
- 打开插件页：
https://marketplace.visualstudio.com/items?itemName=ms-python.python，确认 URL 中itemName是ms-python.python - 右侧 Resources → 点
Download Extension：这个动作生成的是一次性有效、含微软签名的临时 URL，版本/平台/签名三者全对 - 需要批量或历史版本？用 API 拼：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/{version}/vspackage，其中{version}必须和 Version History 里完全一致（如2026.6.123456），不能四舍五入或省略补零 - 下载后重命名加平台标识，例如
python-2026.6.123456-darwin-arm64.vsix，M 系 Mac 上误装 x64 版会静默失效
code --install-extension 总不生效？先关干净再加参数
命令行安装不是“有文件就能跑”，VSCode 对进程状态和校验极其敏感：
-
command not found: code：不是 PATH 问题，是 VSCode 从未启用 Shell Command。在 VSCode 里按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 还在后台运行。Windows 下任务管理器杀掉所有Code.exe，macOS/Linux 执行pkill -f "Code Helper"，连托盘图标都要右键退出 - 路径含中文或空格（如
C:\用户\张三\vsix\python.vsix）会静默失败，务必移到纯英文路径，例如C:\vsix\python.vsix；Windows 下推荐用正斜杠：code --install-extension "C:/vsix/python.vsix"
装上了却不工作？核心依赖和 LSP 二进制没落地
ms-python.python 的 .vsix 只是外壳，首次激活时会联网拉 pyright（Pylance 底层）、debugpy 等二进制。离线环境下它们根本不会出现：
- 必须同步下载依赖插件：
ms-python.vscode-pylance、ms-python.debugpy、ms-vscode.js-debug（调试器底层依赖），版本号要严格对齐，比如python-2026.6.123456.vsix配pylance-2026.6.123456.vsix - 更稳妥的做法：在一台同版本、能联网的机器上，完整打开一个
.py文件 → 等状态栏变绿（LSP 启动完成）→ 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2026.6.123456/）打包复制到离线机对应路径 - 验证是否真落地：打开 VSCode →
View → Output→ 切换到Python或Pylance面板，如果看到Failed to fetch或spawn ENOENT，说明 server 二进制缺失
最容易被忽略的一点：不是所有 .vsix 都含 native binary，但 Python 插件依赖的 pyright 和 debugpy 是编译好的二进制，架构错（如 ARM Mac 装 x64）、路径错、权限错，都会导致功能静默降级为纯文本编辑——连语法高亮都没有。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
