在PHP项目开发中，PHP CS Fixer是维护代码风格一致性的常用工具，它会按照预设规则自动修复代码格式问题。但部分场景下我们可能需要临时跳过某些代码片段的检查，比如引入的第三方代码片段、临时调试的代码块等，此时就需要掌握临时忽略检查的方法。
通过注释临时忽略单段代码
PHP CS Fixer支持通过特定注释标记来临时忽略指定代码块的检查，这是最常用的临时忽略方式，适合小范围代码片段的跳过。
忽略单个代码行的语法如下：
<?php
// @phpcs:disable
function temp_function() {
// 这里的代码不会触发风格检查
$a = 1;
}
// @phpcs:enable
</pre>如果需要忽略特定规则的单个代码行，可以在注释中指定规则名称：
<?php
// @phpcs:disable PSR2.Methods.MethodDeclaration
function temp_function() {
// 仅忽略PSR2方法声明规则的检查
$a = 1;
}
// @phpcs:enable PSR2.Methods.MethodDeclaration
</pre>通过配置文件排除特定文件或目录
如果需要临时忽略整个文件或目录的检查，可以修改PHP CS Fixer的配置文件，在排除列表中添加对应路径。
假设项目根目录下的.php-cs-fixer.php配置文件内容如下：
<?php
return (new PhpCsFixerConfig())
->setRules([
'@PSR12' => true,
])
->setExcludePaths([
// 临时排除的目录
'temp_code/',
// 临时排除的单个文件
'app/ThirdParty/temp_lib.php',
]);
</pre>修改配置后，执行检查命令时就会自动跳过这些文件或目录，需要恢复检查时只需从排除列表中移除对应路径即可。
通过命令行参数临时指定检查范围
如果只是单次执行检查时临时忽略部分内容，不需要修改配置文件，可以在执行命令时通过参数指定排除项。
命令格式如下：
php vendor/bin/php-cs-fixer fix --exclude=temp_code/ --exclude=app/ThirdParty/temp_lib.php
</pre>这种方式适合临时调试场景，不会修改项目的永久配置，执行完成后下次检查仍会按照默认配置进行。
不同方法的适用场景对比
| 方法 | 适用场景 | 生效范围 |
|---|---|---|
| 注释标记 | 单段代码片段临时跳过 | 仅标记的代码片段 |
| 配置文件排除 | 整个文件或目录长期临时跳过 | 指定文件或目录 |
| 命令行参数 | 单次检查临时跳过 | 本次命令执行过程 |
注意事项
- 临时忽略检查仅适合短期场景，长期忽略会导致代码风格碎片化，影响团队协作。
- 使用注释标记时，要确保
@phpcs:disable和@phpcs:enable成对出现，避免影响后续代码的检查。 - 排除路径时要使用相对项目根目录的路径，避免路径匹配错误。
PHP_CS_Fixer代码风格检查忽略规则注释配置自定义规则修改时间：2026-06-30 22:54:29