PHP7.3php-cs-fixer v3 自定义规则，忽略指定目录文件格式化配置-php教程-PHP中文网

php cs fixer v3 不支持按代码块或单行跳过规则，仅可通过配置文件中的 finder 设置 exclude 或 notpath 精确排除目录或文件；exclude 用于忽略整个目录（如 legacy、generated），notpath 用于忽略特定文件（如 bitwisehelper.php），路径均相对于 in() 指定的根目录，且在 --dry-run 模式下同样生效。

php7.3php-cs-fixer v3 自定义规则，忽略指定目录文件格式化配置

PHP CS Fixer v3 在 PHP 7.3 环境下支持通过配置文件灵活排除指定目录或文件，但不支持按代码块或某几行临时跳过规则——所有匹配的文件内容都会被统一处理。唯一可靠的方式是在 `.php-cs-fixer.php`（或 `.php-cs-fixer.dist.php`）中，用 Finder 配置精确控制作用范围。

配置 exclude 排除整个目录

适用于长期不需要格式化的遗留模块、第三方适配层或生成代码目录（如 vendor、Legacy、public/assets）：

在 setFinder() 中调用 exclude()，传入相对路径字符串或字符串数组
路径是相对于 in() 指定根目录的，不是项目根目录
排除后，该目录及其子目录下的所有 PHP 文件完全不参与扫描和修复

示例配置：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

use PhpCsFixer\Config;
use PhpCsFixer\Finder;

return (new Config())
  ->setRules(['@PSR12' => true, 'array_syntax' => ['syntax' => 'short']])
  ->setFinder(
    (new Finder())
      ->in(__DIR__ . '/src')
      ->exclude(['Legacy', 'Generated']) // ← 忽略 src/Legacy 和 src/Generated
  );