在 composer.json 的 scripts 中应写为 "fix": "vendor/bin/php-cs-fixer fix --verbose --diff"，显式调用本地二进制文件并启用调试输出；规则配置须用 --config=.php-cs-fixer.php 而非 --rules 硬编码，确保可复现；Git Hook 中需绝对路径调用并加 --dry-run 预检；PHP 与 php-cs-fixer 版本必须严格匹配，建议 Composer 锁定小版本。
composer.json 里 scripts 怎么写 fix 命令
直接在 scripts 里加一条命令，让 Composer 调用 php-cs-fixer 执行修复，是最轻量、最可控的方式。不需要额外写 shell 脚本或 wrapper，也避免了全局安装带来的版本混乱。
常见错误是把命令写成 "fix": "php-cs-fixer fix"，结果报错 Command "php-cs-fixer" not found——因为 Composer 默认只在 vendor/bin/ 下找可执行文件，而 php-cs-fixer 安装后实际路径是 vendor/bin/php-cs-fixer，必须显式调用。
- 推荐写法：
"fix": "vendor/bin/php-cs-fixer fix --verbose --diff" - 加
--verbose能看到哪些文件被改了，--diff输出具体修改内容，方便 Code Review - 如果项目根目录有
.php-cs-fixer.php或.php-cs-fixer.dist.php，它会自动加载；没配就走默认规则集 - 别用
php-cs-fixer全局命令，否则 CI 或新同事拉代码后容易因本地环境不一致导致格式化结果不同
php-cs-fixer 的 --rules 和 --config 到底怎么选
规则配置方式直接影响修复行为是否可复现。用 --rules 是临时覆盖，适合单次调试；用 --config（指向一个 PHP 文件）才是项目级长期维护的正解。
容易踩的坑：有人在 scripts 里硬编码一堆 --rules="{...}"，结果 JSON 字符串里引号和转义出问题，命令直接失败；还有人把规则写进 composer.json 的 extra 字段，但 php-cs-fixer 根本不读那里。
-
--config=.php-cs-fixer.php是标准做法，文件返回一个数组，比如return ['@PSR12' => true, 'array_syntax' => ['syntax' => 'short']] -
--rules只适合 CLI 临时试规则，例如vendor/bin/php-cs-fixer fix src/ --rules='{"no_unused_imports":true}' - 注意：PHP 8.1+ 的
match表达式、属性提升等语法，需要对应新版规则（如@PHP81Migration），老规则集可能跳过或报错
为什么 vendor/bin/php-cs-fixer 在 Git Hook 里跑不通
Git Hook（比如 pre-commit）里执行 composer run fix 或直接调 vendor/bin/php-cs-fixer 失败，大概率是 PATH 或工作目录问题，不是权限或命令不存在。
Hook 脚本默认以 Git 仓库根为当前目录运行，但某些环境（如 Windows Git Bash、CI 的非交互式 shell）不会自动加载 ~/.bashrc，PATH 里没有 vendor/bin，或者 php 版本跟 Composer 不一致。
- 安全写法是在 Hook 脚本里显式指定路径：
#!/bin/sh\nphp vendor/bin/php-cs-fixer fix --dry-run || exit 1 - 加
--dry-run预检，避免 Hook 提交中断时留下半修复状态 - 别依赖
composer run在 Hook 里执行——它会启动完整 Composer 运行时，慢且可能触发 autoload 重建，干扰 Hook 流程 - 如果用 Husky + simple-git-hooks 等 JS 工具链，记得用
cross-env保证php可执行文件路径正确
PHP 版本升级后 php-cs-fixer 突然不认语法了
不是配置错了，是 php-cs-fixer 版本和 PHP 运行时不匹配。比如用 PHP 8.2 运行 v3.5.0 的 fixer，遇到 #[\Attribute] 属性语法会直接抛 ParseError，而不是跳过或警告。
官方策略很明确：每个 php-cs-fixer 小版本只保证兼容一个 PHP 主版本。v3.10+ 才完整支持 PHP 8.2，v3.14+ 开始实验性支持 PHP 8.3。查错第一步永远是看 php-cs-fixer --version 和 php -v 是否对得上。
- Composer 安装时锁定小版本：
"friendsofphp/php-cs-fixer": "^3.12.0"，避免^3.12自动升到不兼容的 v3.13（若当时还没适配你的 PHP） - CI 中显式声明 PHP 版本，并在 install 后加验证步骤：
php vendor/bin/php-cs-fixer --version && php -v - 本地开发建议用
phpbrew或asdf管理多 PHP 版本，避免系统 PHP 和项目要求错位
真正麻烦的不是命令写不对，而是规则文件里混用了不同 PHP 版本的语法特性，又没配对应的 Migration 规则集——这时候 php-cs-fixer 会静默跳过那些文件，你根本不知道格式化漏了哪儿。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
