问题场景

• 不小心提交了 API 密钥、密码
• 配置文件中包含真实域名或个人信息
• 已推送到 GitHub 等公开仓库

解决方案’"

方法一：使用 git filter-branch（内置工具）

适用于替换历史中所有提交的某个文件内容。

# 1. 暂存当前未提交的更改
git stash'"

# 2. 替换历史中所有 README.md 文件里的敏感内容
FILTER_BRANCH_SQUELCH_WARNING=1 git filter-branch --force --tree-filter \
  "find . -name 'README.md' -exec sed -i '' 's/敏感内容/替换内容/g' {} \;" \
  -- --all

# 3. 恢复暂存的更改
git stash pop

# 4. 强制推送到远程仓库（覆盖历史）
git push origin main --force

参数说明

方法二：使用 BFG Repo-Cleaner（推荐，更快）

适用于删除大文件或敏感文件。

# 安装 BFG
brew install bfg

# 删除某个文件的所有历史
bfg --delete-files 敏感文件.txt

# 或替换敏感文本
bfg --replace-text passwords.txt

# 清理并强制推送
git reflog expire --expire=now --all
git gc --prune=now --aggressive
git push origin main --force

方法三：使用 git filter-repo（官方推荐）

# 安装
brew install git-filter-repo

# 替换敏感内容
git filter-repo --replace-text <(echo '敏感内容==>替换内容')

# 重新添加远程并推送
git remote add origin https://github.com/user/repo.git
git push origin main --force

注意事项

1. 强制推送有风险：会覆盖远程历史，协作者需要重新克隆仓库
2. 轮换密钥：敏感信息一旦泄露，应立即轮换（如重新生成 API Key）
3. GitHub 缓存：GitHub 可能会缓存提交，联系 GitHub 支持可请求清除
4. 本地备份：操作前建议备份仓库 <code>cp -r .git .git.backup</code>

预防措施

• 使用 <code>.gitignore</code> 忽略敏感文件
• 使用环境变量存储敏感配置
• 提交前检查 <code>git diff –staged</code>
• 启用 GitHub 的 Secret Scanning 功能

总结

1. git stash – 暂存当前未提交的更改
2. git filter-branch –tree-filter – 遍历所有历史提交，用 sed 替换敏感内容
3. git stash pop – 恢复暂存的更改
4. git push –force – 强制推送覆盖远程历史

Git Bash 是基于 MinGW + Bash 的，因此语法与 Linux 一致。

1⃣ 设置 HTTP / HTTPS 代理

export http_proxy=http://127.0.0.1:10808
export https_proxy=http://127.0.0.1:10808

export http_proxy=http://127.0.0.1:10808
export https_proxy=http://127.0.0.1:10808

如果你的代理需要用户名密码：

export http_proxy=http://user:password@127.0.0.1:10808

export http_proxy=http://user:password@127.0.0.1:10808

2⃣ 验证是否设置成功

echo $http_proxy
echo $https_proxy

echo $http_proxy
echo $https_proxy

3⃣ 测试是否生效

curl https://ipinfo.io

curl https://ipinfo.io

如果返回的 IP 地址与你本地不同（或与代理服务器一致），说明代理生效。
若不生效，可以强制使用：

curl -x $http_proxy https://ipinfo.io

curl -x $http_proxy https://ipinfo.io

4⃣ 临时取消代理

unset http_proxy
unset https_proxy

unset http_proxy
unset https_proxy

二、Git 自身的代理设置（推荐用于 Git 命令）

Git 不一定会读取系统环境变量，因此可以单独设置：

1⃣ 设置全局 Git 代理

git config --global http.proxy http://127.0.0.1:10808
git config --global https.proxy http://127.0.0.1:10808

git config --global http.proxy http://127.0.0.1:10808
git config --global https.proxy http://127.0.0.1:10808

2⃣ 查看当前配置

git config --global --get http.proxy
git config --global --get https.proxy

git config --global --get http.proxy
git config --global --get https.proxy

3⃣ 取消代理

git config --global --unset http.proxy
git config --global --unset https.proxy

git config --global --unset http.proxy
git config --global --unset https.proxy

推荐组合使用场景

一、添加 Submodule

1. 在主项目仓库中执行：

git submodule add https://github.com/your-org/your-library.git src/YourLibrary

2. 初始化并更新 submodule：

git submodule update --init --recursive

3. 提交变更：

git add .gitmodules src/YourLibrary
git commit -m "Add submodule YourLibrary"

二、在 .NET Core 项目中引用

有两种常见方式：

方式 1：直接作为项目引用

1. 在主解决方案中添加子项目：

dotnet sln add src/YourLibrary/YourLibrary.csproj

2. 在主项目中引用：

dotnet add src/MainProject/MainProject.csproj reference src/YourLibrary/YourLibrary.csproj

这样子模块的代码会直接参与编译和调试。

方式 2：作为 NuGet 包

如果子模块仓库本身会打包成 NuGet 包，可以：

1. 在子模块目录里生成包：

cd src/YourLibrary
dotnet pack -c Release

2. 在主项目中添加本地源或上传到私有 NuGet Server，然后引用。

这种方式更适合多人协作或多个项目依赖同一个库的场景。

三、更新 Submodule

当子模块仓库有更新时：

cd src/YourLibrary
git checkout main
git pull origin main
cd ../..
git add src/YourLibrary
git commit -m "Update YourLibrary submodule"

主项目会记录子模块的 commit id。团队成员只需执行：

git submodule update --init --recursive

就能保持一致。

四、注意事项

1. 避免循环依赖：子模块不能再依赖主项目。

2. 团队协作：确保大家 clone 时用 <code>–recursive</code>：

   git clone --recursive https://github.com/your-org/your-project.git

3. 切换分支：记得子模块也可能需要单独切换分支。

4. CI/CD：在 CI 脚本中要执行 <code>git submodule update –init –recursive</code>。