离线安装VSCode插件失败主因是.vsix版本不匹配、拖拽未进工作区或语言服务器未预下载；需校验package.json中engines.vscode字段与本地code --version兼容，且Python/TypeScript类插件须拷贝完整扩展目录而非仅.vsix文件。
离线环境里装不上插件，八成不是 VSCode 有问题，而是 .vsix 文件本身没对上版本、没拖对地方，或者你以为装好了，其实语言服务器根本没拉下来。CodeMetrics 这类轻量插件能直接用，但 Python/TypeScript 插件离线后大概率“已安装却失能”——得提前把依赖也打包进来。
怎么确认 .vsix 文件能不能用
别信文件名，得看里面有没有 package.json，以及它声明的 VSCode 版本是否匹配你本地的版本。
- 用
unzip -l your-extension.vsix检查顶层目录是不是extension/，否则就是被浏览器解压过或改名失败 - 解压后打开
extension/package.json，找"engines": { "vscode": "^1.85.0" }字段，和你本地code --version输出的第一段（如1.90.2→ 取1.90）比对：必须满足语义化版本规则（^1.85.0允许1.85.x到1.90.x，但不接受1.84.x） - ARM Mac 上装 x64 构建的插件（尤其含
node_modules/.bin二进制的），也会报Extension is not compatible with Code，得找带darwin-arm64的版本
拖进去没反应？先检查这三件事
VSCode 离线安装最顺的方式就是拖 .vsix 文件进主编辑区，但它对运行状态很敏感。
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），不能停在“欢迎页”或“无窗口”状态
- 窗口得有系统焦点——点一下编辑器空白处，任务栏图标高亮了再拖；全屏、RDP、TeamViewer 下拖放常被拦截
- 别双击
.vsix，Windows 默认可能用 Edge 打开，或者弹“无法安装”，必须拖进编辑区松手
装完显示“已安装”，但 Python 补全不工作
这是离线场景下最典型的假成功：插件主体装进去了，但 pyright、debugpy 这类 native 依赖根本没下载，状态栏卡在 Downloading... 或输出面板报 Failed to fetch。
- 解决办法不是重装
.vsix，而是在有网机器上完整走一遍流程：打开.py文件 → 触发下载 → 等状态栏变绿/输出面板不再报错 → 关闭 VSCode - 然后拷整个插件目录过去，路径示例：
%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0（Windows）$HOME/.vscode/extensions/ms-python.python-2024.6.0（macOS/Linux） - 只拷
.vsix文件或只拷package.json是无效的，node_modules和二进制可执行文件都在这个文件夹里
CodeMetrics 能直接离线用，但要注意语言支持边界
它不依赖网络、不拉 language server，只要 .vsix 版本对得上，拖进去就能在状态栏看到 C: X M: Y L: Z，但解析能力有硬限制。
- 光标必须落在函数体内（
function foo() {}、const bar = () => {}、async method() {}），类声明、空行、JSX 混写 HTML 都会返回N/A - 支持
.js、.ts、.py、.java、.cs，但对.jsx或.tsx中的 JSX 块解析不稳定 - 阈值调太低（比如
"codemetrics.complexityThreshold": 3）会导致大量误报，设成6是人工复查的合理起点，11就该强制拆分
真正难搞的从来不是“装不上”，而是“装上了但不动”。离线环境下，插件是否生效，得看输出面板（View → Output）、状态栏实时反馈、以及能否调出对应命令（比如 Python: Select Interpreter），而不是只信扩展列表里的勾选框。
