若CodeMetrics插件无法显示指标，需依次检查：插件启用与语言适配、工作区配置文件.codedmetrics.json是否存在、对应语言分析工具（如radon/escomplex）是否安装并正确配置路径、重启语言服务器并刷新指标。
如果您在 Visual Studio Code 中安装了 CodeMetrics 插件，但无法正确显示函数圈复杂度、可维护性指数或行数等指标，则可能是由于插件未激活、项目配置缺失或语言支持不匹配所致。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、确认插件已启用并适配当前语言
CodeMetrics 插件需针对具体编程语言启用分析器，若打开的文件类型未被插件识别，指标将不会渲染。该插件默认支持 C#、TypeScript、JavaScript、Python 和 Java，但部分语言需额外配置语言服务器或依赖工具链。
1、点击 VSCode 左侧活动栏的扩展图标（方块拼图），在搜索框中输入 CodeMetrics。
2、确认插件状态为“已启用”，且作者为 Cawa-AS（非同名其他插件）。
3、打开一个源码文件（如 index.ts 或 main.py），观察右下角状态栏是否出现 CodeMetrics: Ready 提示。
二、检查工作区根目录是否存在配置文件
CodeMetrics 插件依赖项目级配置文件来确定分析范围与规则阈值。若缺失配置，插件可能跳过计算或仅对单文件局部生效。
1、在 VSCode 资源管理器中，右键点击工作区根文件夹，选择 在终端中打开。
2、执行命令 code .codemetrics.json 创建配置文件。
3、在新建文件中粘贴标准模板，确保包含 "enabled": true 与至少一项语言配置，例如 "javascript": { "enabled": true }。
三、验证语言服务与依赖工具是否就绪
对于 Python 和 JavaScript 等动态语言，CodeMetrics 实际调用外部 CLI 工具（如 radon、escomplex）进行静态分析；若对应工具未全局安装或路径不可达，指标将为空。
1、打开终端，运行 radon --version（Python 项目）或 npx escomplex --version（JS/TS 项目）验证工具存在。
2、若提示命令未找到，执行 pip install radon 或 npm install -g escomplex 安装。
3、在 VSCode 设置中搜索 codemetrics.python.radonPath，将其值设为 radon（若已加入 PATH）或完整路径（如 /opt/homebrew/bin/radon）。
四、重启语言服务器并强制刷新指标
VSCode 的语言服务器缓存可能导致 CodeMetrics 数据未及时更新，尤其在修改配置或切换分支后。需手动触发重载以同步分析上下文。
1、按下 Cmd+Shift+P（macOS）调出命令面板。
2、输入并选择 Developer: Restart Language Server。
3、等待右下角提示 Language server restarted 后，保存当前文件并再次聚焦编辑器窗口。
