离线安装VSCode插件失败主因是vscode版本、.vsix结构或安装路径未对齐；需确认VSCode真就绪、校验engines.vscode兼容性、手动补全语言服务器依赖并冷重启。
离线安装 VSCode 插件失败，八成不是操作错了，而是 vscode 版本、.vsix 结构或安装路径三者中至少有一项没对齐。别反复拖拽重试，先盯住这三点。
拖拽 .vsix 没反应？先确认 VSCode 是“真就绪”
VSCode 启动 ≠ 可接收拖拽。它必须同时满足：有系统焦点（任务栏图标高亮）、未全屏、没走 RDP/TeamViewer 远程桌面，且你拖的是**未解压的原始 .vsix 文件**。
- 任务栏图标没高亮？点一下编辑器空白处再拖
- 用 RDP 或 TeamViewer 连内网机器？退出全屏，或改用
code --install-extension命令行方式 - 浏览器把
python.vsix自动存成python.vsix.zip？别右键重命名，用 PowerShell 执行：Copy-Item "python.vsix.zip" "python.vsix" -Force
code --install-extension 报 ENOENT 或 not compatible with Code？查路径和版本
ENOENT 通常不是路径写错，而是 code 命令根本没注册进系统 PATH；not compatible with Code 则几乎全是 engines.vscode 版本不匹配导致的静默拒绝。
- 先运行
code --version，取结果里第一个小数点前的两位（如1.85.2→1.85） - 用
unzip -p your.vsix extension/package.json | grep engines（Linux/macOS）或 7-Zip 打开查看"vscode": "^1.80.0"—— 你本地版本必须 ≥ 这个值 - Windows 下路径含空格或中文？必须加英文双引号：
code --install-extension "C:\my ext\python.vsix" - 提示
command not found: code？在 VSCode 里按Ctrl+Shift+P，输入Shell Command: Install 'code' command in PATH并执行
插件装了但 Python/Prettier 不工作？语言服务器依赖没带进来
很多插件（如 ms-python.python、esbenp.prettier-vscode）首次启用时会自动下载二进制依赖（pyright、prettierCLI），离线环境卡在 “Downloading…” 就是这个原因。
- 别只拷
.vsix，要提前在有网机器上完整跑一遍：打开一个.py文件 → 触发下载 → 等状态栏不显示 “Downloading” → 再去%USERPROFILE%\.vscode\extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux）里整个拷对应文件夹（如ms-python.python-2024.6.0/） - 手动复制后，必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
最易被忽略的一点：插件离线部署不是“装完就完”，而是“装完 + 依赖落地 + 编辑器冷重启”三步缺一不可。尤其当插件带原生二进制依赖时，.vsix 本身只是启动器，真正干活的模块得靠首次激活时拉取——这一步在离线环境必须提前模拟到位。
