Pint 默认仅扫描指定目录，配置文件pint.json必须位于根目录且命名严格、语法合法；路径错误、换行符差异、CI中未安装dev依赖或PHP版本过低均会导致异常。
直接运行 ./vendor/bin/pint 就能修复大部分风格问题，但默认只扫 app、config、database、routes、tests 这几个目录——漏掉 src、packages 或自定义命令目录是常见失误。
为什么 pint.json 改了却没生效
不是配置没写对，而是 Pint 对配置文件极其“较真”：
-
pint.json必须放在项目根目录，名字不能带点、不能大写、不能加.config后缀 - JSON 语法必须严格合法：不能有末尾逗号、不能用单引号、不能有注释
- 一旦文件存在，Pint 就完全忽略内置 preset，全部按你写的来——哪怕你只写了
"preset": "laravel"，它也不会自动补上默认paths - 改完立刻跑
./vendor/bin/pint --test，如果输出no files found，八成是paths里路径拼错了或目录不存在
--test 模式下报错但不提示具体原因
--test 只输出“哪些文件不合规”，不告诉你哪条规则触发了问题。排查时得配合规则名定位：
- 常见报错如
array_syntax、binary_operator_spaces、blank_line_after_opening_tag，都对应 PHP-CS-Fixer 的原生规则名 - 想确认某条规则是否启用，可在
pint.json中显式声明并设为false，比如："array_syntax": false - 如果
--test报错但本地 IDE 显示正常，检查是否混用了 Windows 换行符（\r\n）——Pint 在 Linux/macOS CI 环境下对换行敏感
CI 中 Could not open input file: vendor/bin/pint
这根本不是 Pint 本身的问题，而是环境没装对：
- GitHub Actions / GitLab CI 里执行
composer install时，必须去掉--no-dev——Pint 是dev依赖 - Docker 构建中若用了 composer vendor 缓存，要确保缓存 key 包含
composer.lock的 hash，否则可能复用旧缓存，缺pint二进制 - Linux/macOS 下 CI 脚本里跑
vendor/bin/pint前，建议加一句chmod +x vendor/bin/pint，避免权限错误 - PHP 版本低于 8.1？Pint v1.x 不兼容，会静默失败或报
PHP version is lower than required
最常被忽略的点：Pint 只处理真实 PHP 文件，不解析 Blade 模板里的 @php 块，也不碰 .php 后缀但内容是纯 JSON 或 YAML 的配置文件——它靠文件头和实际语法判断，不是靠后缀猜。
