如何用当前可见版本文件替换Git所有分支历史中的对应文件？

原脚本的问题 #

1. 直接将Bash变量$FILE_PATH嵌入Python代码，若路径含空格、特殊字符会触发Python语法错误
2. 使用了错误的blob属性名：git filter-repo的blob对象中，文件路径对应的属性是blob.path，而非filepath
3. 若传入绝对路径，blob.path是相对仓库根的路径，二者无法匹配

修正后的脚本 #

#!/bin/bash
FILE_PATH="$1"

# 校验路径格式：必须是仓库根目录下的相对路径
if [[ "$FILE_PATH" == /* ]]; then
    echo "错误：请传入仓库内的相对路径，不要使用绝对路径"
    exit 1
fi

# 保存当前文件的最新内容到临时文件
cp "$FILE_PATH" "/tmp/git_target_file_content"

# 通过环境变量传递路径，避免Bash字符串与Python代码的冲突
export REPLACE_TARGET_PATH="$FILE_PATH"

# 执行git filter-repo替换历史中的文件内容
git filter-repo --force --blob-callback '
import os
target_path = os.environ["REPLACE_TARGET_PATH"].encode("utf-8")
if blob.path == target_path:
    with open("/tmp/git_target_file_content", "rb") as f:
        blob.data = f.read()
'

# 清理临时文件
rm "/tmp/git_target_file_content"

关键注意事项 #

• 备份仓库：git filter-repo会重写整个Git历史，操作前务必备份整个仓库目录
• 强制推送远程：若仓库关联远程，执行完脚本后需要用git push --force --all推送修改，同时通知所有协作者重新克隆仓库（旧历史已失效）
• 彻底清除残留：若要完全移除旧文件的blob数据，可执行：

  git reflog expire --expire=now --all && git gc --prune=now --aggressive
  

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