根本原因是 vendor/bin 未加入 path 或全局安装后未启用执行权限；需局部安装并用 ./vendor/bin/php-cs-fixer 调用，或确保全局路径已配置且 windows 启用脚本策略；配置文件必须为 .php-cs-fixer.php 或 .php-cs-fixer.dist.php 且置于项目根目录。
composer install php-cs-fixer 时提示 command not found
根本原因不是没装上，而是没把 vendor/bin 加进系统 PATH，或者用了全局安装但没启用可执行权限。PHP-CS-Fixer 默认只在项目本地可用，php-cs-fixer 命令不会自动注册到 shell。
- 推荐用局部安装：
composer require --dev friendsofphp/php-cs-fixer，然后通过./vendor/bin/php-cs-fixer调用 - 如果坚持全局安装，运行
composer global require friendsofphp/php-cs-fixer后，必须确认~/.composer/vendor/bin（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）已在 PATH 中 - Windows 用户常见坑：PowerShell 默认禁止运行本地脚本，需先执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
php-cs-fixer 配置文件怎么写才生效
配置文件名必须是 .php-cs-fixer.php 或 .php-cs-fixer.dist.php，且必须放在项目根目录；其他名字（比如 phpcsfixer.php）或放错位置都不会被识别。
- 最简可用配置示例（PHP 8.0+ 语法）：
<?php return PhpCsFixer\Config::create() ->setRules([ '@PSR12' => true, 'array_syntax' => ['syntax' => 'short'], 'no_unused_imports' => true, ]) ->setFinder(PhpCsFixer\Finder::create()->in(['src', 'tests'])); -
setFinder()很关键：不设的话默认只扫描当前目录，子目录可能被跳过 - 规则数组里用
'@PSR12' => true表示启用整套 PSR-12 规范，但某些子规则会被后续条目覆盖（如array_syntax），顺序有影响
运行 php-cs-fixer fix 报错 “Could not open input file”
这个错误几乎全是路径问题：要么当前工作目录不对，要么 --path-mode=override 用错了，要么传入了不存在的文件路径。
- 务必在项目根目录下运行命令，而不是
src/或vendor/子目录 - 修复单个文件时，用相对路径（如
./src/Helper.php），别用绝对路径或漏掉./ - 想递归处理整个目录，直接用
./vendor/bin/php-cs-fixer fix src，不要加--path-mode—— 这个参数只在极少数需要强制重映射路径时才用 - 如果用 Git 钩子自动触发，注意钩子执行时的工作目录可能是
.git/上层，得显式cd $(git rev-parse --show-toplevel)
PHP-CS-Fixer 和 PHP_CodeSniffer 冲突吗
不冲突，但职责不同：PHP-CS-Fixer 专注「自动修复」格式问题（比如缩进、括号、空格），PHP_CodeSniffer（PHPCS）侧重「静态检查 + 报告」，本身不改代码。两者可以共存，但配置要分开维护。
立即学习“PHP免费学习笔记（深入）”；
- PHPCS 规则靠
phpcs.xml或ruleset.xml控制，和.php-cs-fixer.php无关 - 如果同时用，建议先跑
php-cs-fixer再跑phpcs，否则 PHPCS 可能报一堆格式类警告，干扰真正逻辑问题 - 性能上，PHP-CS-Fixer 对大项目更慢（尤其启用了
no_unused_imports），而 PHPCS 检查更快但报告粒度粗
