Composer怎么安装PHP CS Fixer_Composer如何引入代码格式化工具统一编码风格【教程】-composer-PHP中文网

vendor/bin/php-cs-fixer 不可执行因未加执行权限或环境不识别软链接；配置文件须置于根目录并返回 config 实例；换行符问题源于 git 与工具行尾策略冲突。

composer怎么安装php cs fixer_composer如何引入代码格式化工具统一编码风格【教程】

因为 php-cs-fixer 默认以 bin 方式安装，但它的可执行文件不会自动加入系统 PATH，且部分 shell 环境（比如 Windows Git Bash 或某些 Docker 容器）不识别 vendor/bin/ 下的软链接或包装脚本。

先确认是否真装上了：composer show friendsofphp/php-cs-fixer，有输出才说明依赖已存在
Linux/macOS 下直接运行：vendor/bin/php-cs-fixer --version；如果报 “Permission denied”，用 chmod +x vendor/bin/php-cs-fixer 补权限
Windows CMD/PowerShell 中别用 vendor/bin/php-cs-fixer，改用 vendor\bin\php-cs-fixer.bat
某些 CI 环境（如 GitHub Actions）需显式加 ./vendor/bin/php-cs-fixer，前面的 ./ 不能省——否则 shell 会去 PATH 里找，找不到

它必须放在项目根目录，且文件名、返回值、语法三者缺一不可；常见错误是用了 return 但没返回 Config 实例，或者用了旧版数组配置格式（v3+ 已废弃）。

必须以 return 开头，返回 PhpCsFixer\Config 对象，例如：

return PhpCsFixer\Config::create()->setRules(['@PSR12' => true]);

规则名要写对：@PSR12 是预设集，strict_types 是单个规则，混用时注意引号和布尔值写法
如果本地跑命令没报错但格式没变，先检查是不是指定了错误路径：php-cs-fixer fix src/ --config=.php-cs-fixer.php，路径不对会导致配置被忽略
配置中 ->setFinder(...) 很关键：不设的话默认只处理 .php 文件，但不会递归进子目录，得手动加 $finder->in(__DIR__.'/src')

直接写 "cs": "php-cs-fixer fix" 看似方便，但跨平台和路径兼容性极差；尤其 Windows 上会找不到命令，且无法传递参数。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

推荐写成："cs": "php ./vendor/bin/php-cs-fixer fix --config=.php-cs-fixer.php"，显式用 php 调用，绕过 shell 解析差异
加 --dry-run --diff 到 dev 脚本里做预检："cs:check": "php ./vendor/bin/php-cs-fixer fix --dry-run --diff"，CI 中用这个避免意外改代码
不要在 scripts 里写绝对路径或假设 vendor/bin 在 PATH 里——不同环境 PATH 差异大，硬编码必挂
如果项目用 PHP 8.1+ 但 CI 用 PHP 7.4，记得在 php-cs-fixer 的 require-dev 中锁版本："friendsofphp/php-cs-fixer": "^3.14"，新版可能依赖高版本反射 API

本质是 line ending 和 core.autocrlf 冲突，不是工具问题；php-cs-fixer 默认按当前系统换行符写入，而 Git 可能做了透明转换。

先统一 Git 行尾设置：git config core.autocrlf input（macOS/Linux）或 git config core.autocrlf true（Windows），再重置工作区：git rm --cached -r . && git reset --hard
在 .php-cs-fixer.php 里显式指定换行符：->setLineEnding("\n") 强制 LF，避免混用
别用 IDE 自带的“重新格式化”功能配合 php-cs-fixer —— 两者换行策略可能打架，建议关掉 IDE 的自动格式化，只信 php-cs-fixer
团队共用时，在项目根加 .gitattributes：
```
* text=auto eol=lf
```
，比靠人记配置更可靠