vendor/bin/phpcs 未生成是因为 phpcs 包未在 composer.json 的 "bin" 字段声明，需安装官方 squizlabs/php_codesniffer 并确认其 composer.json 含 "bin": ["phpcs", "phpcbf"]。
composer install 之后为什么没生成 vendor/bin/phpcs
因为 phpcs 默认不进 vendor/bin/，除非你装的是全局可执行的 dev 依赖，且包声明了 bin 字段。很多代码检查工具（比如 phpcs、phpcbf）本身是 PHAR 包或带脚本入口的，但 Composer 只会软链那些在 composer.json 的 "bin" 里明确定义的命令。
实操建议：
- 确认你装的是
phpcs官方包：composer require --dev squizlabs/php_codesniffer（不是php-code-sniffer或其他 fork） - 装完后检查
vendor/squizlabs/php_codesniffer/composer.json是否有"bin": ["phpcs", "phpcbf"]—— 新版 3.x 是有的，2.x 没有，得手动调用vendor/bin/phpcs路径或升级 - 如果仍没生成，直接运行
vendor/bin/phpcs会报错“找不到命令”，这时用php vendor/squizlabs/php_codesniffer/bin/phpcs绕过软链也行
phpcs 校验失败却没提示具体哪行违规
常见于配置文件缺失或规则集（standard）没指定。默认 phpcs 不自带规则，只提供解析引擎；你必须告诉它用哪个标准检查，否则它什么也不报。
实操建议：
- 先跑一次
phpcs -i看已安装的标准列表，常见有PSR12、PEAR、Squiz—— 如果空着，说明没装标准，得手动加，比如composer require --dev phpcompatibility/php-compatibility - 校验时必须带
-s（显示源码行）和--standard=PSR12，例如：phpcs --standard=PSR12 --report=full src/ - 别依赖
.phpcs.xml自动加载：Composer 安装后不会自动识别项目根目录下的配置，得显式用--configuration=.phpcs.xml或确保文件名是phpcs.xml（注意不是.xml前缀）
phpcbf 自动修复后代码格式反而乱了
因为 phpcbf 和 phpcs 版本不一致，或用了不兼容的 standard。比如 PSR12 在 phpcs 3.5.0+ 才完整支持，而旧版 phpcbf 会把 function (int $a) 错误改成 function(int $a)（少空格），破坏语法。
实操建议：
- 统一版本：装
squizlabs/php_codesniffer:^4.0（目前最稳），避免混用 3.x 和 4.x - 修复前先备份或走 Git：用
git stash或git checkout -- .预留回退路径 - 不要全量
phpcbf --standard=PSR12 .，先小范围试：phpcbf --standard=PSR12 src/MyClass.php，看输出是否含FIXED行，再观察 diff - 某些规则（如
Generic.Files.LineEndings）可能和 IDE 换行符冲突，可在.phpcs.xml中禁用：<rule ref="Generic.Files.LineEndings"><severity>0</severity></rule>
CI 流水线里 phpcs 报错但本地不报
根本原因是 PHP 版本或扩展差异。比如 phpcs 4.x 要求 PHP 7.4+，CI 用的是 8.1，你本地是 8.2，看着一样，但某些 token 解析行为微调过；更常见的是 tokenizer 扩展没开，或者 mbstring 编码处理不一致。
实操建议：
- CI 脚本里加检查：
php -m | grep -E 'tokenizer|mbstring'，缺就装（Docker 里常漏php-tokenizer） - 本地和 CI 用同一套
phpcs版本：在composer.json锁死"squizlabs/php_codesniffer": "4.1.0"，别用^4.0 - CI 日志里搜
PHP Fatal error或Warning: Failed to load，这类错误会让phpcs静默退出，看起来像“没报错”，其实是挂了
工具链越往后越依赖环境一致性，尤其是 phpcs 这种靠 AST 解析的 —— 差一个 PHP 补丁版本，就可能让 FunctionDeclaration 节点结构变个字段名，整个规则失效。
