如何在分支上按提交执行git-clang-format且仅针对指定路径，同时避免新增格式化提交

我太懂这种不想用额外格式化提交污染分支历史的心情了！之前我在自己的开发分支上做了好几个提交，部分文件的代码需要用clang-format规整，但又不想专门加个“Clang format files”这类提交——毕竟这类提交对代码逻辑毫无帮助，只会让提交记录变得杂乱。

先说说大家常用的临时解决方案，虽然不是我们最终想要的：

• 用git clang-format main -- path/to/files/to/format命令，对比当前分支和main分支的差异，只对指定路径的文件执行格式化。之后你可以把格式化后的修改单独提交，但这就会多一个纯粹的格式化提交，达不到我们“无额外提交”的目标。

后来我找到了一个能直接改写历史提交的方法，把格式化操作整合到对应的提交里，完全不用新增提交。我把这个方法做成了bash函数，放在.bashrc里方便日常使用：

clang-format-branch() {
    # 传入基准提交的SHA或分支名（比如main）
    base_ref=$1
    # 使用git filter-branch逐个处理基准提交之后的所有提交
    git filter-branch -f --tree-filter '
        # 对指定路径的文件，基于基准提交执行clang-format格式化
        git clang-format --style=file '"$base_ref"' -- path/to/files/to/format
        # 如果格式化后有文件修改，把修改添加到当前提交中
        git add path/to/files/to/format
    ' "$base_ref"..HEAD
}

使用方法： #

1. 确保你当前在需要处理的分支上
2. 运行clang-format-branch main（这里的main是你的基准分支，也可以换成具体的提交SHA）
3. 这个命令会遍历从main之后的所有提交，自动对指定路径的文件执行格式化，并把格式化的修改直接合并到对应的提交里，不会产生新的格式化提交

⚠️ 注意事项：

• git filter-branch会改写分支历史，如果你的分支已经推送到远程仓库，执行后需要强制推送（git push -f），但这样会影响其他协作者，所以操作前一定要确认分支只有你自己在使用
• 建议操作前先备份分支：git branch backup-my-branch，避免操作失误丢失代码

备注：内容来源于stack exchange，提问作者MrBerta