Composer安装PHP_CodeSniffer后phpcs命令找不到，因默认仅装入项目vendor/bin/目录且未加入PATH；需用./vendor/bin/phpcs（Linux/macOS）或vendor\bin\phpcs.bat（Windows）调用，或全局安装并确保~/.composer/vendor/bin在PATH中。
Composer安装PHP_CodeSniffer后为什么phpcs命令找不到？
因为Composer默认只把工具装进项目本地的vendor/bin/目录，不加入系统PATH。直接运行phpcs会提示“command not found”。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 用
./vendor/bin/phpcs（Linux/macOS）或vendor\bin\phpcs.bat（Windows）调用，最稳妥 - 全局安装可执行
composer global require "squizlabs/php_codesniffer=*" --with-all-dependencies，但要注意~/.composer/vendor/bin是否已在PATH中 - 别用
--global加--dev混用——Composer会报错：dev依赖不能全局安装
怎么让PHP_CodeSniffer检查时自动修复常见问题？
phpcbf（PHP Code Beautifier and Fixer）是配套工具，但默认不随squizlabs/php_codesniffer一起启用，需确认是否已安装（它和phpcs同属一个包，只要版本≥3.5.0就自带）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先运行
./vendor/bin/phpcbf --standard=PSR12 app/试修，再用phpcs复查 - 注意
phpcbf不是万能的：比如无法重排if嵌套结构、不处理注释格式、对类型声明缩进可能误判 - CI流程中建议只用
phpcs做检查，phpcbf留给人手跑——避免自动修复引入语义变化
如何在Composer项目中统一配置标准而不靠命令行参数？
硬编码--standard=PSR12在CI脚本里容易漏改，也难同步到IDE。推荐用配置文件驱动。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在项目根目录放
phpcs.xml（或phpcs.xml.dist），内容至少包含<rule ref="PSR12"></rule> - 支持按目录排除：
<exclude-pattern>tests/*</exclude-pattern>，比--ignore更易维护 - VS Code装PHP Intelephense插件后，设
"intelephense.environment.includePaths"无用；必须在设置里指定"intelephense.completion.snifferPath"指向./vendor/bin/phpcs
为什么CI里phpcs退出码总是0，即使有错误？
默认行为是报告问题但不中断流程，导致质量门禁失效。关键在退出码逻辑：只有--report=checkstyle配合--error-severity等参数才可控。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- CI命令务必加
--report=full --severity=5（5是warning及以上），这样有warning就返回非0 - 若用GitLab CI，别写
script: phpcs src/，要写成script: ./vendor/bin/phpcs --standard=PSR12 --report=full --severity=5 src/ || exit 1 - 注意
phpcsv3和v4的--encoding默认值不同（v3是ISO-8859-1，v4是UTF-8），中文注释报错时先检查版本和编码声明
phpcs.xml里没设<arg name="basepath" value="."></arg>，导致路径输出带绝对路径前缀，CI解析checkstyle报告失败。这个细节在本地跑没问题，一上流水线就卡住。 
