如何在clang-format 3.9中忽略指定文件或目录？

没问题，因为clang-format 3.9本身没有直接的全局忽略参数，但我们可以通过调整git diff的输出或者在Python脚本里做筛选来实现这个需求。结合你现有的Travis配置和检查脚本，这里有几个实用的方案：

方案1：通过git diff+grep过滤文件（最快捷） #

你当前的脚本是用git show获取变更diff，我们可以换成更灵活的git diff命令，配合grep排除不想检查的路径。比如要忽略third_party/整个目录和test/demo.cpp文件，修改check_patch.py里的cmd变量即可：

cmd = """git diff origin/master..@ --name-only | grep -v "third_party/" | grep -v "test/demo.cpp" | xargs clang-format-diff-3.9 -p 1 -style=file"""

原理说明： #

• git diff origin/master..@ --name-only：只列出本次补丁变更的所有文件路径
• grep -v "路径"：反向匹配，排除包含指定路径的文件
• xargs：把筛选后的文件列表传给clang-format-diff，确保它只处理需要检查的文件

方案2：在Python脚本中做精细化筛选（更灵活） #

如果需要更复杂的忽略规则（比如按文件后缀筛选、多目录批量忽略），可以在Python脚本里先获取所有变更文件，再手动过滤：

更新后的check_patch.py脚本如下：

#!/usr/bin/env python3
from subprocess import Popen, PIPE
import sys

# 获取本次变更的所有文件
git_proc = Popen("git diff origin/master..@ --name-only", stdout=PIPE, shell=True, text=True)
changed_files = git_proc.communicate()[0].splitlines()

# 定义要忽略的路径（支持目录前缀或完整文件路径）
ignored_paths = [
    "third_party/",
    "docs/",
    "test/utils.cpp"
]

# 筛选出需要检查的文件（还可以额外加后缀过滤，比如只留.cpp/.h）
target_files = []
for file in changed_files:
    # 跳过被忽略的路径
    if any(file.startswith(path) or file == path for path in ignored_paths):
        continue
    # 可选：只保留C++相关文件
    if file.endswith((".cpp", ".h", ".cc", ".hpp")):
        target_files.append(file)

# 没有需要检查的文件就直接通过
if not target_files:
    sys.exit(0)

# 对筛选后的文件执行clang-format检查
cmd = f"echo '{chr(10).join(target_files)}' | xargs clang-format-diff-3.9 -p 1 -style=file"
diff_output = Popen(cmd, stdout=PIPE, shell=True, text=True).communicate()[0]

if diff_output:
    print("Code formatting does not follow style guidelines.")
    sys.exit(1)
sys.exit(0)

这个方案的好处是可以自定义各种筛选逻辑，比如只检查C++源文件，或者忽略某个子目录下的所有内容，非常灵活。

方案3：单个文件添加忽略注释（适合少量文件） #

如果只是少数几个文件需要忽略，可以在文件的最开头添加注释：

// clang-format off

这样clang-format会跳过整个文件的格式化检查。不过这个方法需要逐个修改文件，适合不想批量配置的场景。

注意：clang-format 3.9不支持在.clang-format配置文件中用Excludes字段（这个功能是后续版本才加的），所以没法通过配置文件直接全局忽略目录。

最后，你只需要更新check_patch.py的逻辑，.travis.yml不需要做任何修改。建议先在本地运行脚本测试一下，确认忽略规则生效后再推送到Travis CI。

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