如何用git filter-repo修改Git仓库历史中JSON文件的指定行

前提准备 #

确保已经安装git filter-repo（部分Git版本未默认集成，需单独安装）。

操作步骤 #

1. 克隆仓库镜像
   为避免误操作损坏原仓库，先克隆镜像仓库：

git clone --mirror <你的仓库远程URL>
cd <仓库名称>.git

2. 选择修改方式
   推荐两种方式，优先选脚本方式以保证JSON结构安全：

方式一：Python脚本（可靠，避免JSON格式破坏）

创建处理脚本replace_foo.py：

#!/usr/bin/env python3
import json
import sys

def main():
    content = sys.stdin.read()
    try:
        data = json.loads(content)
        if "FOO" in data and data["FOO"] == "yes":
            data["FOO"] = "no"
        print(json.dumps(data, indent=4))
    except json.JSONDecodeError:
        print(content, end='')

if __name__ == "__main__":
    main()

给脚本添加执行权限：

chmod +x replace_foo.py

执行filter-repo命令（替换config.json为你的目标JSON文件名）：

git filter-repo --path config.json --command 'replace_foo.py'

方式二：正则替换（简单但需注意边缘情况）

直接用正则匹配替换（同样替换config.json为目标文件名）：

git filter-repo --path config.json --replace-text <(echo 'regex:("FOO":\s*")yes(") replacement:\1no\2')

3. 强制推送修改后的历史
   处理完成后，推送到远程仓库（此操作会重写历史，需提前告知团队成员）：

git push --force

注意事项 #

• 操作前务必备份原仓库，防止数据丢失
• 重写历史后，团队成员需重新拉取仓库，或基于新历史进行rebase操作
• 若仓库体积较大，git filter-repo的处理速度远优于已弃用的git filter-branch

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