Code Metrics Analysis 是一个代码质量指标度量与分析工具，目标是衡量并分析代码质量指标，以识别复杂度、可维护性问题以及可改进的区域。
用途 该工具用于评估代码质量、识别可重构的候选代码、监控技术债务、自动化代码审查、设置 CI/CD 质量门禁、跟踪团队绩效以及分析遗留代码。
主要能力 该工具能够分析圈复杂度（cyclomatic complexity）、认知复杂度（cognitive complexity）、代码行数、函数数量、类数量以及最大嵌套深度等指标。资料中提供了一个基于 TypeScript 编译器 API 和文件系统读取的最小工作示例，定义了 ComplexityMetrics 接口，包含 cyclomaticComplexity、cognitiveComplexity、linesOfCode、functionCount、classCount、maxNestingDepth 字段，并通过 CodeMetricsAnalyzer 类的 analyzeFile 方法读取文件并创建源码文件对象以进行分析。完整实现需参考 reference guides。
参考指南 资料列出以下参考实现方向：TypeScript Complexity Analyzer（TypeScript 复杂度分析器）、Python Code Metrics（使用 radon，Python 代码指标）、ESLint Plugin for Complexity（ESLint 复杂度插件）、CI/CD Quality Gates（CI/CD 质量门禁）。
使用方式 资料给出的是最小工作示例：通过 import * as ts from "typescript" 与 import * as fs from "fs" 引入依赖，使用 fs.readFileSync 读取文件内容，再通过 ts.createSourceFile 创建源码文件对象进行分析。完整实现未在资料中提供，需查阅 references/ 目录下的参考指南。
最佳实践 建议遵循以下做法：随时间持续监控指标；设定合理的阈值；关注趋势而非绝对数值；自动化指标收集；使用指标指导重构；组合使用多个指标；在代码审查中纳入指标。 不建议：将指标作为唯一的质量指标；设定不切实际的阈值；忽略上下文与领域；因指标惩罚开发者；只关注单一指标；跳过文档。
适用场景 适用于代码质量评估、重构候选识别、技术债务监控、代码审查自动化、CI/CD 质量门禁、团队绩效跟踪、遗留代码分析。
限制 资料未提供具体功能的完整实现细节、安装命令、收费方式、价格、平台支持或实际效果说明；部分内容需参考 references/ 目录中的参考指南。