需在ThinkPHP 8.0项目中配置Husky+lint-staged实现pre-commit自动检查：初始化Husky、配置lint-staged仅扫描暂存区PHP/HTML文件并执行php-cs-fixer和phpstan，再通过php-no-debug或shell脚本拦截调试语句，确保提交前规范与安全。
在 ThinkPHP 8.0 项目中，每次提交前手动运行 phpstan、php-cs-fixer、git status 检查是否漏加文件或存在未处理的 console/debugger，既打断开发节奏又容易遗漏。你需要一套稳定、轻量、开箱即用的 pre-commit 防守机制，让规范检查成为 Git 提交流程中不可跳过的自然环节。
初始化 Husky 环境
TP8.0 项目默认不带钩子管理器，必须用 Husky 而非手写 .git/hooks/pre-commit —— 后者在 Windows 下常因换行符、PATH 缺失、node_modules/.bin 路径解析失败而静默失效。【Husky 会自动注入环境变量并跨平台解析 package.json scripts】
执行以下命令：
npx husky-init && npm install
该命令会：自动创建 .husky 目录、改写 .git/hooks/pre-commit 为 Husky 托管脚本、并在 package.json 中插入 "prepare": "husky install"。
配置 lint-staged 精准检查变更文件
全量扫描 app/ 和 route/ 目录下所有 PHP 文件会拖慢提交速度，尤其在 vendor 已安装大量依赖时可能卡顿 8 秒以上。必须只检查本次 git add 进暂存区的文件。
安装依赖：
npm install --save-dev lint-staged
在 package.json 中添加配置段（注意缩进必须为 2 空格，JSON 不允许注释）：
"lint-staged": { "app/**/*.{php,html}": ["php-cs-fixer fix --dry-run --using-cache=no", "phpstan analyse --no-interaction"], "route/**/*.{php}": ["phpstan analyse --no-interaction"] }
⚠️ 注意：glob 匹配路径基于项目根目录，不是 .git 目录；若你把控制器放在 app/controller/，请确保路径写成 "app/controller/**/*.{php}"。
绑定 pre-commit 钩子执行 lint-staged
进入 .husky/pre-commit 文件，替换全部内容为：
#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"
npx lint-staged
这一步不能省略 husky.sh 的引入 —— 它负责加载正确的 Node 环境和 PATH。
保存后，无需 chmod +x，Husky 已自动设好权限。
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
补充：拦截危险调试语句（console/debugger）
TP8.0 项目中残留 console.log 或 dump() 会暴露调试信息到生产日志，甚至引发 JSON 输出中断。需单独拦截。
方法一：用 shell 脚本原生过滤
在项目根目录新建 scripts/check-debug.sh，内容如下：
#!/bin/sh
for file in $(git diff --cached --name-only --diff-filter=ACM | grep '\.php$'); do
if grep -nE 'console\.log|dump\(|dd\(|debugger|var_dump\(|print_r\(' "$file" >/dev/null 2>&1; then
echo "❌ $file 包含调试语句，请删除后再提交";
exit 1
fi
done
给脚本加执行权限：
chmod +x scripts/check-debug.sh
然后在 .husky/pre-commit 最后一行追加：
sh ./scripts/check-debug.sh
方法二：复用 ESLint 思路（推荐）
安装 php-no-debug：
npm install --save-dev php-no-debug
在 lint-staged 配置中加入：
"app/**/*.{php}": ["php-no-debug check"]
该工具专为 PHP 设计，能识别 var_dump、dd、dump、debug_print_backtrace 等 12 种常见调试调用，并精准定位行号。
验证钩子是否生效
第一步：修改一个控制器文件，在某行插入 dd('test');
第二步：git add app/controller/IndexController.php
第三步：git commit -m "test debug hook"
如果看到 ❌ 提示并终止提交，说明钩子已激活；若直接提交成功，检查 .husky/pre-commit 是否被其他命令覆盖、scripts/check-debug.sh 是否有 CRLF 换行符、或 lint-staged 是否匹配到了该文件路径。
