离线安装vscode插件后python功能不生效，根本原因是语言服务器（如pyright、pylance）未下载或未激活；必须在有网机器上首次打开.py文件触发完整下载并拷贝整个扩展目录（含native二进制），而非仅传输.vsix文件。
离线环境里装插件不难，难的是装完 Python 补全、格式化、语法检查这些功能根本不动——不是没装上，是语言服务器（LSP）压根没跑起来。
拖 vsix 进 VSCode 没反应？先看这三件事
最常卡在这一步：把 .vsix 文件拖进编辑器主区域，松手没弹框。这不是 VSCode 坏了，而是条件没凑齐：
- VSCode 必须已加载一个工作区（哪怕只是打开一个空文件夹），纯启动页不响应拖放
- 窗口得有系统焦点——点一下编辑区再拖；任务栏图标没高亮，大概率没焦点
- 别拖解压后的文件夹或
.zip，必须是原始未解压的.vsix（用unzip -l xxx.vsix看顶层是不是extension/目录）
code --install-extension 报 “not compatible with Code” 怎么办
这个报错 95% 是版本不匹配，不是网络问题。VSCode 安装时会硬比对 package.json 里的 "engines": {"vscode": "^1.80.0"} 和你本地 code --version 输出的第一段（如 1.85.2 → 取 1.85）。
- 解压
.vsix，用unzip -p xxx.vsix extension/package.json | grep engines（Linux/macOS）或 7-Zip 打开查字段 - ARM Mac 装了 x64 版本的插件（比如含
pyright二进制的ms-python.python），也会触发同类报错，得找带darwin-arm64标识的 vsix - Windows 上路径含空格必须加英文双引号：
code --install-extension "C:\my ext\python-2024.6.0.vsix"
插件列表显示“已安装”，但 Python 补全/格式化不生效
这是离线环境最典型的假成功：插件本身装上了，但首次启用时要自动下载 pyright、black、isort 这类语言服务器或 CLI 工具，默认走外网，离线就卡在状态栏“Downloading…”或输出面板报 Failed to fetch。
- 解决办法不是重装
.vsix，而是在有网机器上完整跑一遍：打开.py文件 → 触发下载 → 等状态栏变绿 → 再把整个扩展目录（如~/.vscode/extensions/ms-python.python-2024.6.0）拷到内网机对应路径 - 不能只拷
.vsix文件，要拷解压后的完整文件夹；否则 native 二进制缺失，pyright启动直接报spawn ENOENT - 验证是否真活：打开命令面板（
Ctrl+Shift+P），输Python: Select Interpreter；再看输出面板（View → Output）切换到Python通道，有没有Starting Pylance server或类似日志
真正麻烦的从来不是“怎么装”，而是“装完之后它到底有没有连上自己的语言服务器”。离线部署时，少一次有网环境下的首次激活，就等于留了个哑巴插件在那儿占位置。
