如何通过Composer安装常用的代码规范检查工具
一个核心原则：务必使用 composer require --dev 在项目内安装，全局安装的隐患，远比你想象的多。
项目级安装能锁定版本、避免跨项目冲突，并且通过 Composer Scripts 统一调用，能确保从本地开发到持续集成（CI）环境的行为完全一致。相比之下，全局安装极易导致 PATH 问题、权限混乱，更致命的是，它会让你的所有项目被迫“强制升级”。
为什么必须用 --dev 而不是全局安装
全局安装的 phpcs 或 php-cs-fixer 就像一颗定时冲击波。一旦工具本身升级，所有依赖它的老项目都可能突然报错。举个例子，PHPCS 4.x 版本对 PHP 8.3 的 #[\Override] 属性支持若有变动，你的 CI 流水线可能说挂就挂。而项目级安装则不同，composer.json 里白纸黑字地写着 "squizlabs/php_codesniffer": "^4.0"，无论谁拉取代码、在哪个环境运行检查，结果都一模一样。
那些令人头疼的全局安装错误，根源往往在此：
Could not open input file: phpcs：不是没装上，而是系统的 PATH 环境变量里根本没包含全局的 bin 目录。Permission denied（常见于 Linux/macOS）：一开始图省事用了sudo composer global require，导致权限混乱，后续所有global命令都可能失败。- Windows 上报
The system cannot find the path specified：十有八九是%USERPROFILE%\AppData\Roaming\Composer\vendor\bin这个路径没被添加到环境变量。
phpcs 和 php-cs-fixer 该装哪个
这俩工具定位不同，并非“二选一”的关系，而是互补的黄金搭档：
phpcs（squizlabs/php_codesniffer）：专职检查，不修改代码。它像一位严格的代码审计员，非常适合在 CI 环节设置卡点，或者在提交 Pull Request 前进行检查。php-cs-fixer（friendsofphp/php-cs-fixer）：专注自动修复格式问题，比如调整空格、括号、数组语法等。但它通常不处理语义层面的规范，例如变量命名是否符合 PSR-1。- 因此，实际项目中更稳妥的做法是两个都装：
composer require --dev squizlabs/php_codesniffer friendsofphp/php-cs-fixer。
这里有个细节值得注意：phpcbf 虽然是 phpcs 自带的修复工具，但其能力远弱于 php-cs-fixer，尤其对 PHP 8.2+ 的新语法支持往往滞后。一个典型的坑是，它可能把正确的 function (int $a) 错误地“修复”成 function(int $a)（少了空格），直接导致语法错误。
装完怎么验证能用
先别急着跑全盘检查，安装后的验证步骤至关重要，能帮你提前排除大部分配置问题：
- 进入项目根目录，运行
./vendor/bin/phpcs -i：如果能看到PSR12、Generic等编码标准列表输出，才说明标准加载成功。如果列表是空的，那意味着没装规则包，需要补上composer require --dev phpcompatibility/php-compatibility。 - 运行
./vendor/bin/php-cs-fixer --version：确认输出的是3.59.0或更高的主流版本。旧版本对#[\Deprecated]这类属性的识别可能不准。 - 检查配置文件的名字和位置是否正确：
phpcs.xml（注意不是.phpcs.xml）、.php-cs-fixer.dist.php（注意不是phpcsfixer.php），并且它们必须放在项目根目录。
几个常见的坑：phpcs --standard=psr12PSR12；php-cs-fixer fix src/ 报 Could not open input file——多半是因为当前目录不在项目根，或者指定的 src/ 路径根本不存在。
怎么让命令变短、易记、可复用
秘诀在于利用 composer.json 的 scripts 字段来封装命令，而不是去修改复杂的 shell PATH。
- 在
composer.json的scripts部分添加类似下面的配置："cs:check": "phpcs --standard=PSR12 --report=full src/", "cs:fix": "phpcbf --standard=PSR12 src/", "cs:fix-all": "php-cs-fixer fix --config=.php-cs-fixer.dist.php"
- 配置好后，只需运行
composer run cs:check即可，无需记忆冗长的完整路径。 - 更重要的是，CI 脚本中也统一使用
composer run cs:check，这样能彻底避免因开发者本地环境 PATH 差异而导致的流程失败。
最后，一个真正容易被忽略的关键点是：PHPCS 默认不携带任何编码规则，因此 --standard= 参数不是可选项，而是必填项。而 php-cs-fixer 如果找不到配置文件，则会退回到其极简的内置规则集，这直接会导致团队成员间的代码格式千差万别，失去了统一规范的意义。
