php-cs-fixer 是主流php代码风格修复工具，支持php+html混合文件但需手动启用html感知模式；--dry-run用于预览修改，避免误格式化关键文件，ci中须配合缓存使用。
PHP-CS-Fixer 是当前最主流、最可靠的选择，它能真正“修复”而非仅检查风格问题，且对 PHP+HTML 混合文件有实际支持能力。
为什么不用 php-cs-fixer --dry-run 就直接 fix？
因为 --dry-run 不改文件但会输出 diff，是 CI/CD 和代码审查前的必经步骤；而直接 fix 会立即写入修改，一旦规则配置不当或 Finder 范围错误，可能误格式化 vendor、config 或模板中本不该动的 HTML 结构。
- 本地开发建议先跑
php-cs-fixer fix --dry-run --diff确认改动范围和内容 - CI 流程中必须用
--dry-run+--using-cache，避免因缓存缺失导致误报失败 - 某些规则（如
no_unused_imports）在--dry-run下可能不触发，需结合静态分析工具交叉验证
如何让 php-cs-fixer 正确处理含 HTML 的 PHP 文件？
默认情况下，php-cs-fixer 只解析 PHP 代码块，但若文件以 .php 结尾且混有大量 HTML（如 Laravel Blade 模板、原生 PHP 模板），需显式启用 HTML 感知模式 —— 这不是默认行为，也**不会自动识别 <?php 外的 HTML 标签**。
- 确保配置中设置了
'php_unit_test_case_static_method_calls' => false类规则不干扰模板逻辑 - 在
Finder中明确包含.php文件，排除.blade.php（除非你用的是新版 v3.15+ 并启用了html扩展支持） - 对纯 HTML 模板（如
.html或.twig），php-cs-fixer完全无效，应换用 Prettier 或专门的 HTML 工具
composer.json 里写 "format": "php-cs-fixer fix" 为什么有时不生效？
因为该命令默认在当前工作目录执行，但 php-cs-fixer 会从其自身所在位置（vendor/bin/）启动，导致 Finder 的路径解析错位，尤其当配置文件用 __DIR__ 动态构造路径时。
- 正确写法是：
"format": "vendor/bin/php-cs-fixer fix"（显式指定路径） - 若项目根目录无
.php-cs-fixer.php，它会 fallback 到默认规则，可能和你预期不符 - Windows 下 CMD 会忽略双引号内的空格，建议统一用 PowerShell 或 Git Bash 运行脚本
最易被忽略的一点：PHP-CS-Fixer 的缓存机制基于文件哈希与规则哈希双重校验，一旦你改了配置但没清缓存（php-cs-fixer fix --clear-cache），它可能跳过本该处理的文件 —— 这个行为没有提示，只能靠 --verbose 观察日志确认是否真在扫描。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
