Git利用本地挂钩自动核验分支代码圈复杂度并预警-git-PHP中文网

pre-commit钩子不适合圈复杂度实时核验，因其仅能访问暂存区diff片段，无法获取函数完整结构、跨文件调用关系及AST解析所需全量源码，易导致漏报或误报；推荐改用pre-push钩子进行轻量全量扫描，或通过lint-staged调度语言层AST分析脚本实现精准预警。

git利用本地挂钩自动核验分支代码圈复杂度并预警

不能直接用 Git 本地挂钩自动计算圈复杂度——因为 pre-commit 钩子只看到暂存区文件，而圈复杂度必须基于完整函数/方法结构分析，且多数工具（如 radon、eslint-plugin-complexity）需要解析 AST 或源码上下文，无法仅靠 diff 片段可靠判断。

为什么 `pre-commit` 钩子不适合圈复杂度实时核验

圈复杂度（Cyclomatic Complexity）本质是统计控制流图中线性独立路径数，依赖函数边界、条件分支、循环、异常处理等完整结构。Git 的 pre-commit 钩子只能拿到 git diff --cached 输出的增量变更，它不提供：

函数是否被完整修改（可能只改了某一行，但影响整个函数逻辑）
新增/删除的函数是否已纳入统计范围（git diff 不标记“新增函数”语义）
跨文件调用关系（复杂度有时需结合调用链评估）
语言特定的 AST 解析环境（比如 Python 的 radon 需读取 .py 文件全文，而非 patch）

强行在 pre-commit 中调用 radon cc -s 或 eslint --rule "complexity: [2, 10]"，会因只扫描暂存文件、忽略未暂存改动、或跳过未修改但已超限的函数，导致漏报或误报。

可行方案：用 `pre-push` 钩子 + 全量文件扫描

真正能落地的自动化预警，得退一步：不在提交时卡住，而在推送前做一次轻量全量检查。这既避开 pre-commit 的上下文缺失问题，又比 CI 延迟更低。

pre-push 钩子可拿到即将推送的所有 commit，用 git rev-list --no-merges @{u}..HEAD 获取待推 commit 范围
对这些 commit 影响的所有 .py 或 .js 文件（用 git diff-tree -r --name-only --no-commit-id --diff-filter=ACM <commit></commit> 提取）执行全文件扫描
使用 radon cc -s -a path/to/file.py（Python）或 eslint --ext .js,.ts --rule "complexity: [2, 12]"（JS/TS），只报告 > 阈值的函数，并输出文件名+行号
若发现单个函数复杂度 ≥ 15（推荐阈值），打印警告但不 exit 1；≥ 20 则 exit 1 阻断推送

示例片段（Python 场景）：

#!/usr/bin/env bash
THRESHOLD_WARN=15
THRESHOLD_BLOCK=20
<h1>获取待推送的所有文件（去重）</h1><p>files=$(git rev-list --no-merges @{u}..HEAD | xargs -I{} git diff-tree -r --no-commit-id --name-only --diff-filter=ACM {} | grep '.py$' | sort -u)</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill3869" title="myfirstgit"><img
														src="https://img.php.cn/upload/skill/000/000/081/178981937135441.jpg" alt="myfirstgit" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill3869" title="myfirstgit" class="overflowclass">myfirstgit</a>
													<p class="overflowclass">通过 CLI 与 GitHub 交互，列出仓库、Issues、Pull Requests，并在自己的仓库中创建新 Issues。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill3869" title="myfirstgit" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><p>if [ -n "$files" ]; then
echo "? 检查圈复杂度（阈值：警告 $THRESHOLD_WARN，阻断 $THRESHOLD_BLOCK）..."
while IFS= read -r f; do
if [ -f "$f" ]; then</p><h1>radon cc 返回非零表示有超限项，但我们要自己解析</h1><pre class="brush:php;toolbar:false;">  result=$(radon cc -s -a "$f" 2>/dev/null | awk -F' |:' -v warn="$THRESHOLD_WARN" -v block="$THRESHOLD_BLOCK" '
    $2 ~ /^[0-9]+$/ && $2 >= block { print "❌ BLOCK:", $1, $2; exit 1 }
    $2 ~ /^[0-9]+$/ && $2 >= warn  { print "⚠️  WARN:", $1, $2; found=1 }
    END { if (found) exit 2 }
  )
  if [ $? -eq 1 ]; then
    echo "$result"
    exit 1
  elif [ $? -eq 2 ]; then
    echo "$result"
  fi
fi

done

更稳的做法：交给 `lint-staged` + 自定义脚本组合

如果团队已在用 lint-staged，不要硬写 shell 钩子——把复杂度检查包装成可并行执行的 Node.js 脚本，再交由 lint-staged 调度，能天然支持多文件并发、缓存、错误聚合：

写一个 check-complexity.js，用 acorn（JS）或 astroid（Python via pyright）解析 AST，精确提取函数节点并计算复杂度
在 lint-staged.config.js 中配：{ "**/*.js": ["node check-complexity.js --max 15"] }
lint-staged 保证只检查暂存文件，且失败时统一提示所有超限项，不中断后续 lint

这种模式绕开了 Git 钩子本身的局限，把“分析能力”下沉到语言工具层，而钩子只负责触发调度器。