codemetrics插件可直接离线安装并立即使用，无需下载语言服务器或二进制依赖；需校验.vsix内extension/package.json的engines.vscode版本与本地code --version兼容，且拖拽安装时vscode须已加载工作区、有系统焦点、使用未解压的.vsix文件。

CodeMetrics 插件能直接离线安装并立即使用，不需要额外下载语言服务器或二进制依赖——这是它和 Python/TypeScript 类插件最本质的区别。

怎么确认你下的 CodeMetrics.vsix 能用

别只看文件名或市场页面写的“支持 VSCode 1.80+”，得进包里验货：

• 用 unzip -l CodeMetrics-*.vsix 检查顶层目录是不是 extension/（不是 package.json 直出、也不是被浏览器自动解压成文件夹）
• 解压后打开 extension/package.json，找 "engines": { "vscode": "^1.85.0" } 字段
• 运行 code --version，取输出前两位（如 1.90.2 → 1.90），必须 ≥ 插件声明的最低版本
• ARM Mac 用户请确认 vsix 名称含 darwin-arm64，否则会报 Extension is not compatible with Code

拖进去没反应？先盯住这三件事

VSCode 对拖拽安装极其敏感，静默失败是常态，不是插件问题：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• VSCode 必须已加载一个工作区：不能停在“欢迎页”，哪怕只是打开一个空文件夹
• 窗口要有系统焦点：点一下编辑器空白处，确保任务栏图标高亮后再拖
• 别在全屏、RDP、TeamViewer 或远程桌面里操作——这些环境会拦截拖放事件

拖的是未解压的 .vsix 文件，不是 .zip、不是重命名过的文件、更不是解压后的文件夹。

装完显示“已安装”，但右键没出现 Complexity 选项

这是典型的“假安装”：插件注册了，但没激活或没匹配文件类型。

• 检查是否手动启用了插件：扩展面板里点插件右侧的「启用」按钮（默认是禁用状态）
• 确认当前打开的是支持的文件：CodeMetrics 只对 .js、.ts、.jsx、.tsx、.html 和 .vue 生效，对 .py 或 .cpp 不响应
• 右键菜单项叫 Calculate Complexity，不是 Code Metrics 或其他变体
• 重启 VSCode：插件启用后有时需完全退出再打开才加载命令

真正容易被忽略的是：CodeMetrics 不做后台分析，它只在你右键触发时即时计算。没有状态栏图标、不自动扫描、也不依赖任何外部服务——所以只要 .vsix 版本对得上、拖对地方、手动启用，它就一定可用。其他插件的“下载 LSP”“启动 server”等环节，在这里根本不存在。