离线安装Python扩展需同步下载依赖插件并确保版本匹配，否则会卡在“Downloading Pylance”等联网步骤；必须用官方.vscode文件、复制完整解压后的扩展目录或通过code --install-extension绝对路径安装，并验证VSCode版本与engines兼容性。
离线安装 Python 扩展（ms-python.python）完全可行，但仅拖进 .vsix 文件 ≠ 能用——它大概率会卡在“Downloading Pylance”或“Starting debugpy”，因为核心依赖（ms-python.vscode-pylance、ms-python.debugpy）默认仍尝试联网拉取二进制。
怎么拿到正确的 .vsix 文件
别从第三方网盘或别人拷来的文件夹里找，必须用官方渠道下载原始 .vsix：
- 打开 https://www.php.cn/link/3d29fb5278af9da98e9e7c9d3c97b9e2，确认右上角显示 “Download Extension” 按钮（不是“Install”）
- 点击后下载的文件名形如
ms-python.python-2024.6.0.vsix，注意末尾是.vsix，不是.zip或文件夹 - 同一页面往下拉，在 “Dependencies” 区域能看到它明确依赖
ms-python.vscode-pylance和ms-python.debugpy——这两个也必须一并下载对应版本的.vsix - 版本必须对齐：比如
ms-python.python-2024.6.0通常要求ms-python.vscode-pylance-2024.6.0，查 GitHub Release 页面或解压.vsix后看package.json里的dependencies字段最准
拖拽安装为什么没反应
VSCode 窗口必须满足三个硬条件，否则拖 .vsix 进去完全静默：
- 已启动且**已加载工作区**：哪怕只是打开一个空文件夹（
File → Open Folder…），不能停留在初始空白页 - 窗口有焦点、未全屏、未处于远程连接（SSH/Dev Containers）未就绪状态
- 右下角状态栏没显示
Extensions disabled by policy—— 如果有，说明组策略锁死了扩展，GUI 和 CLI 都无效 - 拖拽目标必须是编辑器主区域（白色代码区），不是侧边栏、不是设置页、不是终端面板
装完插件不生效的真正原因
扩展面板显示“已启用”，不代表 Python 功能就跑起来了。语言类插件首次激活时会触发离线不可达的操作：
立即学习“Python免费学习笔记（深入）”；
-
ms-python.python启用后，会自动尝试下载pyright（Pylance 底层）或debugpy的独立二进制，状态栏卡在Downloading... - 输出面板（
View → Output）切换到Python或Pylance通道，如果看到Failed to fetch或spawn ENOENT，就是这个原因 - 解决办法不是重装
.vsix，而是在有网机器上完整走一遍流程：打开.py文件 → 等 LSP 启动成功（状态栏变绿）→ 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0/）打包复制到离线机对应路径 - 注意：必须复制解压后的完整文件夹，不是只拷
.vsix；也不能丢掉外层目录名（含版本号），否则 VSCode 无法识别
code --install-extension 报错 Extension is not compatible 怎么办
这不是网络问题，是版本硬校验失败。VSCode 会严格比对 package.json 里的 "engines": {"vscode": "^1.85.0"} 和你本地 code --version 输出的版本（如 1.84.2）：
- 解压
.vsix（它本质是 zip），打开根目录下的package.json，找到engines.vscode字段 - 你的 VSCode 版本号取小数点前两位（
1.84.2→1.84），必须满足 semver 规则（例如^1.85.0要求最低1.85.0） - ARM Mac 上装了 x64 构建的
.vsix（尤其含 native 二进制的插件）也会报同类错，需找带darwin-arm64标识的版本 - 命令行安装必须用绝对路径：
code --install-extension /home/user/downloads/ms-python.python-2024.6.0.vsix，相对路径容易因工作目录不同而失败
离线环境里最容易被忽略的不是下载或安装步骤，而是语言服务器和调试器的二进制是否真落地——它们不藏在 .vsix 里，而是在首次启用时动态拉取。没这一步，补全、跳转、断点全失效，但界面毫无报错提示。
