离线安装python插件失败主因是签名校验失败、lsp服务未落地或依赖缺失；必须加--allow-unverified参数，确保路径纯英文、vscode进程全退出，并同步安装pylance等依赖插件。
离线安装 Python 插件失败，90% 不是插件问题，而是卡在签名校验、依赖缺失或 LSP 服务没落地——装上 ≠ 能用。
code --install-extension 报 INVALID_SIGNATURE 或静默失败
离线环境无法连接微软证书链，VSCode 默认拒绝未验证签名的 .vsix，不报错只跳过安装。
- 必须加
--allow-unverified参数：code --install-extension ms-python.python-2024.6.0.vsix --allow-unverified - 路径含空格或中文会静默失败，Windows 下务必用英文双引号 + 正斜杠：
code --install-extension "C:/vsix/ms-python.python-2024.6.0.vsix" - 执行前确认
code命令可用：在 VSCode 中按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH回车；否则要用绝对路径，例如/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code（macOS） - 所有 VSCode 进程必须彻底退出（包括右下角托盘图标），否则缓存不刷新，安装看似成功实则未生效
拖拽 .vsix 到窗口没反应
这不是文件损坏，是 VSCode 根本没接收拖放事件——它对运行状态极其挑剔。
- VSCode 必须已加载工作区：至少执行一次
File → Open Folder…（哪怕选个空文件夹），纯启动页不响应拖拽 - 窗口必须有系统焦点：任务栏图标高亮，且不能全屏、不能处于 RDP/TeamViewer 远程桌面中
- 拖入的是原始
.vsix文件：用unzip -l python.vsix验证顶层是否为extension/目录，并包含extension/package.json；若显示一堆零散文件，说明已被解压或下载失败 - 别拖进侧边栏、设置页或终端面板——目标区域只能是中央编辑器白底区域
插件列表显示“已启用”，但 Python 功能不工作
ms-python.python 的 .vsix 只是前端壳，真正干活的 pyright（Pylance 底层）、debugpy 等二进制需首次激活时联网下载。离线时它们根本不会落地。
- 不要只拷
.vsix，而要在一台同版本、能联网的机器上完整走一遍流程：打开.py文件 → 等状态栏变绿（显示 “Pylance Ready”）→ 再复制整个扩展目录，例如~/.vscode/extensions/ms-python.python-2024.6.0/（含子目录里的node_modules和 native 二进制） - 必须同步安装依赖插件：
ms-python.vscode-pylance、ms-python.debugpy、ms-vscode.js-debug（Python 调试底层依赖它），缺一不可 - 检查
package.json中"engines": {"vscode": "^1.85.0"}字段，确保你本地code --version输出的前两位（如1.92.2→1.92）≥ 插件要求的最低版本 - ARM Mac（M系列）必须用带
darwin-arm64后缀的.vsix，从 open-vsx 或 marketplace 下载时得手动选平台匹配版本，否则 native 部分静默失效
怎么下载真正能用的 .vsix 文件
第三方打包站、GitHub Release 页面、浏览器插件生成的链接，大概率返回旧版、无签名或平台错配包——唯一稳的方式是走官方直链。
- 打开插件页，例如
https://marketplace.visualstudio.com/items?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 里完全一致（如2024.6.0） - 下载后重命名加平台标识，例如
python-2024.6.0-darwin-arm64.vsix，避免后续误装 - 别信别人分享的网盘链接或“已测试可用”的压缩包——2026 年起 VSCode 强制签名，非官方渠道打包的文件大概率触发
Signature verification failed
最易被忽略的点：LSP 服务不是插件的一部分，而是首次激活时动态拉取的独立二进制；离线环境下，你看到的“已安装”只是注册了前端，后台什么都没跑起来。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
