vendor/bin/php-cs-fixer 不可执行因未加执行权限或环境不识别软链接；配置文件须置于根目录并返回 Config 实例；换行符问题源于 Git 与工具行尾策略冲突。
composer require 之后为什么 vendor/bin/php-cs-fixer 不可执行？
因为 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 里找，找不到
php-cs-fixer 配置文件 .php-cs-fixer.php 怎么写才生效？
它必须放在项目根目录，且文件名、返回值、语法三者缺一不可；常见错误是用了 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')
在 composer.json 的 scripts 里怎么安全调用 php-cs-fixer？
直接写 "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
为什么 php-cs-fixer fix 后 git status 显示大量换行符变更？
本质是 line ending 和 core.autocrlf 冲突，不是工具问题；php-cs-fixer 默认按当前系统换行符写入，而 Git 可能做了透明转换。
立即学习“PHP免费学习笔记（深入）”；
- 先统一 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
，比靠人记配置更可靠
事情说清了就结束。最常卡住的其实是配置文件位置和换行符这两处，其他都是路径或权限的细节问题。
