如何屏蔽项目commit history？需清理历史中的敏感安全数据

不用直接删除项目重传，Git提供了专门的工具可以彻底清除历史中的敏感内容，以下是最稳妥的操作步骤：

• 先做仓库备份
  操作前务必备份整个仓库目录，避免误操作导致数据丢失：

  # Linux/macOS
  cp -r your-repo-name your-repo-name-backup
  # Windows直接复制整个文件夹即可
  

• 使用git filter-repo清除敏感内容
  这是Git官方推荐的工具（已替代老旧的git filter-branch），操作高效且可靠：

  1. 安装git filter-repo：

     pip install git-filter-repo
     

     也可以通过系统包管理器安装（比如Ubuntu用apt install git-filter-repo）。

  2. 清除单个敏感文件：
     将sensitive-file.txt替换为你要删除的实际文件名：

     git filter-repo --path sensitive-file.txt --invert-paths
     

  3. 清除整个敏感目录：
     将sensitive-dir/替换为目标目录：

     git filter-repo --path sensitive-dir/ --invert-paths
     

  4. 清除特定敏感文本（比如密钥、密码）：
     把YOUR_SECRET_VALUE替换为实际敏感内容，REDACTED是替换后的占位符：

     git filter-repo --replace-text <(echo 'YOUR_SECRET_VALUE==>REDACTED')
     

• 强制推送重写后的历史到远程仓库
  操作完成后，需要强制推送覆盖远程仓库的历史：

  # 推送所有分支
  git push origin --force --all
  # 如果有标签也需要同步的话
  git push origin --force --tags
  

• 通知协作成员同步操作
  所有参与项目的协作人员都需要：

  1. 放弃本地原仓库的分支
  2. 重新克隆远程仓库的最新版本
  3. 不要将旧分支合并到新仓库，避免敏感内容再次混入

注意：如果敏感数据已经被第三方平台缓存或爬取，可能需要联系对应代码托管平台的支持团队，请求移除相关快照内容。

内容的提问来源于stack exchange，提问作者João Victor Prado