必须手动执行两步：先运行composer require --dev squizlabs/php_codesniffer，再创建phpcs.xml文件并写入，否则会因缺失包或规则导致“no ruleset found”错误。
Composer init 时怎么自动装 PHP_CodeSniffer 和 PSR-12 配置
不能靠 composer init 默认流程一键拉取规范包——它只管生成 composer.json，不处理 dev-dependency 或配置文件。必须手动补两步：加包、写配置。
常见错误是执行完 composer init 就以为万事大吉，结果跑 phpcs 报错“no ruleset found”，因为没装 phpcodesniffer，也没指定标准。
- 先运行
composer require --dev squizlabs/php_codesniffer（别漏--dev） - 再执行
vendor/bin/phpcs --config-set default_standard PSR12，这步把默认规则写进phpcs.xml或用户级配置里 - 如果项目要团队统一，建议显式建
phpcs.xml文件，内容至少包含<rule ref="PSR12"></rule>，避免依赖全局配置
为什么不用 composer create-project 而用 init + 手动配
因为 create-project 适合模板化启动（比如 Laravel），但标准代码规范不是框架，没有通用“规范模板包”可直接拉。你看到的所谓“一键规范包”，本质是别人封装好的 composer.json + phpcs.xml + scripts 组合，仍需手动 require 并确认路径。
容易踩的坑：有人搜到某个叫 php-cs-fixer-config 的包就直接 require，结果发现它只提供 Fixer 配置，和 PHPCS 冲突；PHPCS 和 PHP-CS-Fixer 是两套工具，不能混用同一份配置。
- PHPCS 用于静态检查（
phpcs命令），输出警告/错误 - PHP-CS-Fixer 用于自动修复（
php-cs-fixer fix），需要单独装friendsofphp/php-cs-fixer - PSR-12 是规则定义，不是可执行包——它内建在
squizlabs/php_codesniffer里，无需额外 require
如何让 phpcs 检查时自动识别项目根目录下的配置
phpcs 默认从当前目录往上找 phpcs.xml 或 phpcs.xml.dist，找不到才 fallback 到用户家目录配置。所以只要确保项目根目录有这个文件，就不用每次加 --standard= 参数。
典型错误是把 phpcs.xml 放错位置（比如放进 src/），或文件名拼错成 phpcs.xml.example——它不会被自动加载。
- 推荐最小可用
phpcs.xml：<?xml version="1.0"?><ruleset name="MyProject"><description>PSR-12 rules</description><rule ref="PSR12"></rule><file>src/</file><file>tests/</file></ruleset>
- 加
<file></file>标签限定范围，避免扫描vendor/或node_modules/ - 如果 CI 中报错 “Could not open input file: vendor/bin/phpcs”，说明没执行
composer install，或者vendor/被 gitignore 了但没在 CI 里重装
scripts 字段里怎么加一键检查命令
在 composer.json 的 scripts 里加一条，比每次敲完整路径方便，也利于 CI 统一调用。
别写成 "cs": "phpcs"——这样会 fallback 到全局安装的 PHPCS，而不是当前项目的 vendor/bin/phpcs，版本可能不一致。
- 正确写法：
"cs": "vendor/bin/phpcs"（Windows 下可用phpcs，但跨平台推荐绝对路径） - 加参数更实用：
"cs": "vendor/bin/phpcs --colors --report=source"，--colors让终端高亮，--report=source显示具体违规代码行 - 想保存报告为 XML 供 CI 解析？加
--report=checkstyle --report-file=build/checkstyle.xml，注意提前建好build/目录
真正麻烦的不是加哪几行，而是团队成员各自本地装了不同版本的 PHPCS，导致检查结果不一致。最稳的做法：锁死 squizlabs/php_codesniffer 的小版本号（如 ^3.6.0），并在 README 里写明“必须用 vendor/bin/phpcs 执行”。
