根本原因是未在composer.json的scripts中注册phpcs命令并指定执行时机；需添加"cs": "phpcs"等脚本，确保php_codesniffer已安装且配置文件（如phpcs.xml）存在。
为什么 composer.json 里加了 phpcs 还不生效？
根本原因不是没装，而是没告诉 Composer 什么时候运行它。Composer 本身不执行代码检查，它只管依赖和脚本调度。你得把 phpcs 命令注册进 scripts 段，并明确调用时机（比如 test 或自定义的 cs）。
-
phpcs必须已全局安装或作为 dev 依赖存在：composer require --dev squizlabs/php_codesniffer
- 在
composer.json的scripts中添加："cs": "phpcs --standard=PSR12 src/ tests/"
- 若想提交前自动检查，可配合
git hooks（如pre-commit），但那是额外层，Composer 本身不触发钩子
如何让 phpcs 支持自定义规则（比如 Laravel 风格）？
直接写 --standard=PSR12 是最简方式，但项目常需微调。推荐用配置文件解耦规则与命令行参数，避免脚本里堆满选项。
- 在项目根目录建
phpcs.xml或phpcs.xml.dist，内容示例：src/ tests/ - 然后简化
composer.json脚本："cs": "phpcs"
（phpcs默认会找phpcs.xml） - 注意：如果同时存在
phpcs.xml和phpcs.xml.dist，前者优先；CI 环境建议用.dist版本并提交到仓库
phpcbf 能不能直接集成进 Composer 脚本自动修复？
能，而且很实用——尤其对团队快速统一风格。但要注意它不是万能的，部分规则（如注释结构、逻辑拆分）无法自动修复，强行跑可能掩盖语义问题。
- 先确保已安装（通常随
squizlabs/php_codesniffer一起）：phpcbf是同一包里的可执行文件 - 在
composer.json添加修复脚本："cs-fix": "phpcbf --standard=phpcs.xml"
- 执行顺序建议：
composer cs先看报告 → 人工确认 → 再composer cs-fix→ 最后composer cs复查 - CI 中慎用
phpcbf自动提交，它可能修改非预期文件（比如没加
为什么本地 composer cs 正常，CI 却报找不到 phpcs？
大概率是 CI 环境没装 php_codesniffer，或者用了不同 PHP 版本导致二进制路径不一致。Composer 脚本中的命令默认走 $PATH，不自动识别 vendor/bin。
立即学习“PHP免费学习笔记（深入）”；
- 解决方案：全部用相对路径调用，强制走 Composer 自动加载的 bin：
"cs": "vendor/bin/phpcs --standard=phpcs.xml"
- CI 配置中确保已运行
composer install --no-interaction --prefer-dist（否则vendor/bin下没可执行文件） - PHP 版本兼容性：PHP 8+ 项目需确认
squizlabs/php_codesniffer版本 ≥ 3.7.2，旧版会报Attribute相关 fatal error
vendor/bin 是否纳入执行路径、以及 phpcbf 修复后是否真能通过检查——有些规则修复后反而触发新警告。 
