Laravel Pint本地与GitLab CI代码检测结果不一致问题咨询

可能原因 #

• Windows路径解析差异：Windows用\作为路径分隔符，Pint内部默认基于Unix风格的/处理路径，全局扫描时路径匹配逻辑出现偏差，导致漏掉了database目录；但单独指定文件时，.\能被正确解析，所以能检测到问题。
• 本地缓存干扰：本地环境可能残留了Pint的缓存文件，导致全局扫描时没有重新扫描目录结构或应用最新规则；GitLab CI是干净的全新环境，没有缓存，所以能正常检测。
• 文件属性影响：Windows下database目录或迁移/种子文件可能带有隐藏属性，Pint全局扫描时跳过了这类文件，但单独指定时不受属性限制。

解决办法 #

1. 显式指定扫描目录
   全局检测时直接列出要扫描的目录，避免路径解析问题：

   php vendor/bin/pint app/ database/ --test -v
   

2. 清除Pint缓存
   删除Pint的缓存目录（一般在vendor/bin/.pint），再重新执行全局检测：

   rmdir /s vendor/bin/.pint
   php vendor/bin/pint --test -v
   

3. 检查隐式规则配置
   确认pint.json中没有意外排除database目录的规则，比如：

   {
     "exclude": ["database/*"]
   }
   

   同时检查是否针对迁移文件设置了特殊规则，导致PHPDoc检查被忽略。
4. 统一使用Unix风格路径
   在Windows命令行中用/作为路径分隔符尝试全局扫描：

   php vendor/bin/pint ./database/migrations/ --test -v
   

5. 更新Pint到最新版本
   可能是版本bug导致的路径解析问题，执行更新：

   composer update laravel/pint
   

内容的提问来源于stack exchange，提问作者Andreas Christodoulou