pre-commit钩子不生效的根本原因是phpcs未正确安装或路径错误，需先在终端执行phpcs --version验证，再确保钩子脚本仅检查暂存区PHP文件、用phpcbf自动修复并重新add，同时PhpStorm中Path、Standard、Config三处配置须与终端一致且Scope设为Project Files。
PhpStorm 里 pre-commit 钩子不生效？先确认 phpcs 能否终端运行
根本原因不是 PhpStorm 设置错了，而是 phpcs 命令压根没装好或路径不对。PhpStorm 不会报错提示你缺工具，它只会安静跳过检查。
必须在终端执行：phpcs --version，看到类似 3.7.2 的输出才算就绪。如果报 command not found：
- 全局安装：用
composer global require squizlabs/php_codesniffer - 项目内安装：进项目目录跑
composer require --dev squizlabs/php_codesniffer - 查路径：
which phpcs（macOS/Linux）或where phpcs（Windows），拿到的必须是可执行文件完整路径，比如/Users/xxx/.composer/vendor/bin/phpcs或C:\Users\xxx\AppData\Roaming\Composer\vendor\bin\phpcs.bat，不能填vendor/bin目录
pre-commit 脚本里为什么只检查暂存区文件？
直接跑 phpcs --standard=PSR12 . 会扫全项目，CI 早该干这事了；提交钩子只该管「这次要提交什么」——也就是 git diff --cached 拿到的暂存区文件。
常见错误是脚本硬编码扫描整个 src/ 或忽略 --diff-filter=ACMR，导致：
立即学习“PHP免费学习笔记（深入）”；
- 未
git add的修改被误报，打断提交流程 - 删掉的文件触发
phpcs报file not found错误 - 二进制或非 PHP 文件（如
.env）被拖进检查，浪费时间甚至失败
正确做法是先过滤出本次暂存的 PHP 文件：git diff --cached --name-only --diff-filter=ACMR | grep '\.php$'
如何让 pre-commit 自动修复而非中断提交？
强制阻断提交容易引发「绕过钩子」行为（比如加 --no-verify），真正可持续的是「改完再提交」。但注意：phpcbf 不能直接改暂存区，得先写回工作区，再重新 git add。
一个轻量可靠的流程：
- 用
phpcs --standard=PSR12 --report=json获取违规文件列表和行号（JSON 更易解析） - 对每个违规文件执行
phpcbf --standard=PSR12 "$file" - 用
git add "$file"把修正后的内容重新加入暂存区 - 最后才跑
phpcs做终验，失败才退出
别用 --dry-run 或只打印建议——那等于没修。也别把 phpcbf 放在 phpcs 前面，否则修复可能引入新问题，终验会失败。
PhpStorm 提交窗口里看不到 phpcs 提示？检查 Inspection 绑定
即使 pre-commit 钩子跑通了，PhpStorm 编辑器里仍不显示波浪线，大概率是 Settings → Languages & Frameworks → PHP → Code Sniffer 三处没对齐：
-
Path to phpcs：必须填绝对路径，且和终端能执行的完全一致（大小写、.bat/.sh 后缀都不能错） -
Configuration：下拉菜单选具体标准，如PSR12；勾选Enable code sniffing却不选标准，等于没开 -
Local configuration file：如果填了路径，必须指向项目根目录下的phpcs.xml或phpcs.xml.dist，且该文件存在、格式合法（可用phpcs --config-show验证）
Scope 设为 Project Files 并关闭 Use cache，否则改了规则也不刷新提示。
.git/hooks/pre-commit 不进版本库，团队成员各自复制粘贴极易版本不一致。更稳妥的做法是用 composer-git-hooks 或 GrumPHP 管理，把钩子逻辑收归 composer.json 和配置文件里。否则，一次重装系统或新同事入职，就得重新手配一遍。 
