PHP CS Fixer 不该全局安装，应按项目独立安装到 dev-dependencies。全局安装会污染依赖、引发版本冲突、CI 失效；项目级安装可锁定版本、提交配置、确保环境一致。
PHP CS Fixer 不该通过 Composer 全局安装——它会污染全局依赖、升级冲突频繁、不同项目需要不同版本时根本没法切换。
为什么 composer global require 是错的
全局安装看似方便，实际是把所有项目的代码风格规则强行统一到一个版本上。比如你用 Laravel 10 的项目需要 php-cs-fixer v3.52，而另一个 Symfony 6.4 项目必须用 v3.58（否则修复会漏掉 declare(strict_types=1)），这时候全局只有一个二进制命令 php-cs-fixer，根本分不清该跑哪个版本。
更麻烦的是：composer global 依赖写在 ~/.composer/composer.json 里，没人维护、不进 Git、CI 环境默认不生效，本地跑得通，流水线直接报 command not found。
- 全局安装后，
php-cs-fixer --version显示的永远是最新装的那个，无法按项目锁定 - 升级时运行
composer global update，可能顺手把phpstan或infection也升了，导致静态分析突然报一堆新错误 -
vendor/bin/php-cs-fixer在全局模式下根本不会生成，你只能靠 PATH 里的软链，而软链指向谁？没人知道
正确做法：每个项目独立安装到 dev-dependencies
把它当成和 phpunit 或 psalm 一样的开发工具，只在当前项目里存在、可提交、可 CI 复现。
立即学习“PHP免费学习笔记（深入）”；
执行这行命令（在项目根目录）：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer require --dev friendsofphp/php-cs-fixer
安装完后，二进制文件就落在 vendor/bin/php-cs-fixer，路径明确、版本锁定、Git 可见。
- 想换版本？改
composer.json里"friendsofphp/php-cs-fixer": "^3.58"，再composer update - CI 脚本里直接写
./vendor/bin/php-cs-fixer fix --dry-run，不用额外 setup 步骤 - 配合
.php-cs-fixer.php配置文件，它自动识别并加载，不需要任何环境变量或参数指定
配置文件 .php-cs-fixer.php 放哪、怎么写才生效
必须放在项目根目录，且文件名不能拼错（不是 .php_cs，不是 php-cs-fixer.php，也不是 config.php）。PHP CS Fixer v3 默认只认这个确切名字。
最简可用配置示例（Laravel 风格）：
<?php
return (new PhpCsFixer\Config())
->setRules([
'@PSR12' => true,
'declare_strict_types' => true,
'array_syntax' => ['syntax' => 'short'],
])
->setFinder(
PhpCsFixer\Finder::create()
->in(['app', 'src', 'tests'])
->name('*.php')
->notName('*.blade.php')
->ignoreDotFiles(true)
->ignoreVCS(true)
);
-
->in([...])路径要写对，别漏掉src或多写了vendor，否则要么不修、要么误伤依赖 - 如果项目有
bootstrap/app.php这类非标准入口，记得加进->name()白名单，否则它跳过不处理 - v3 默认不递归子目录？错——只要
->in()指定的是目录，它自动递归；但->path()才是单文件，别混用
常见报错：找不到规则、Class not found、--dry-run 无输出
报 Invalid configuration: rule "xxx" does not exist，基本是规则名拼错或版本不匹配。比如 'strict_param' => true 在 v3.50+ 已弃用，得换成 'nullable_type_declaration_for_default_null_value' => true。
PHP Fatal error: Class 'PhpCsFixer\Config' not found？说明你用了 v3 的配置语法，但装的是 v2 —— 检查 composer show friendsofphp/php-cs-fixer 输出的版本号，v2 配置是数组格式，v3 是对象链式调用。
-
--dry-run没输出也不报错？先确认当前目录下真有.php-cs-fixer.php，再运行./vendor/bin/php-cs-fixer status看是否识别到文件和目标文件 - Mac 上提示
Permission denied？别chmod +x vendor/bin/php-cs-fixer，那是 PHP 脚本，直接php vendor/bin/php-cs-fixer ...更稳 - Windows Git Bash 下命令卡住？关掉
winpty自动封装：在命令前加winpty -Xallow-non-tty，或者直接用 PowerShell
最常被忽略的一点：PHP CS Fixer 的规则集不是“越全越好”。启用 @Symfony 或 @PhpCsFixer 这种大规则包，很容易把团队没共识的格式（比如花括号换行、箭头函数括号）强行推过去，引发大量无关 diff。从 @PSR12 开始，按需加一两条，比一次性全开靠谱得多。
