场景：日常工作用实名提交，开源项目/技术博客用网名提交，如何优雅地在两个身份之间切换？
痛点分析
很多开发者同时维护：
公司项目 → 需要实名 + 公司邮箱（便于代码审查、绩效关联）
个人开源/博客项目 → 需要网名 + 个人邮箱（保护隐私、建立技术品牌）
常见的错误做法：把实名 commit 推到了 GitHub 公开仓库，或把网名混入了公司 GitLab。
方案一：includeIf 按目录自动切换（推荐）
原理
Git 支持在 ~/.gitconfig 中声明条件包含：当仓库路径匹配指定目录时，自动加载对应的配置文件，完全自动，零操作。
配置步骤
第一步：创建两份身份配置文件
# 工作身份配置
cat > ~/.gitconfig-work << 'EOF'
[user]
name = 张三（实名）
email = zhangsan@company.com
EOF
# 个人/开源身份配置
cat > ~/.gitconfig-personal << 'EOF'
[user]
name = YourNickname
email = your-nickname@gmail.com
EOF
第二步：在 ~/.gitconfig 中配置条件包含
# ~/.gitconfig
[user]
# 默认身份（fallback）
name = YourNickname
email = your-nickname@gmail.com
# 工作目录下的所有仓库，自动覆盖为工作身份
# 注意：路径末尾必须有 /
[includeIf "gitdir:~/work/"]
path = ~/.gitconfig-work
[includeIf "gitdir:~/company/"]
path = ~/.gitconfig-work
# 个人项目目录（可省略，默认就是个人身份）
[includeIf "gitdir:~/study/"]
path = ~/.gitconfig-personal
[includeIf "gitdir:~/opensource/"]
path = ~/.gitconfig-personal
验证效果
# 在工作目录下的仓库
cd ~/work/some-project
git config user.name # 输出：张三（实名）
git config user.email # 输出：zhangsan@company.com
# 在个人项目目录
cd ~/study/build
git config user.name # 输出：YourNickname
git config user.email # 输出：your-nickname@gmail.com
includeIf 的匹配规则
注意：路径末尾的
/不能省略，代表"该目录下所有子目录"。
方案二：Shell 函数一键切换（手动应急）
适合临时在"不归属任何特定目录"的仓库中切换身份。
配置步骤
在 ~/.zshrc（或 ~/.bashrc）中添加以下函数：
# ──────────────────────────────────────────
# Git 身份切换工具
# ──────────────────────────────────────────
# 切换到工作身份（全局）
function git-work() {
git config --global user.name "张三（实名）"
git config --global user.email "zhangsan@company.com"
echo "✅ 已切换到工作身份：$(git config --global user.name) <$(git config --global user.email)>"
}
# 切换到个人/开源身份（全局）
function git-personal() {
git config --global user.name "YourNickname"
git config --global user.email "your-nickname@gmail.com"
echo "✅ 已切换到个人身份：$(git config --global user.name) <$(git config --global user.email)>"
}
# 查看当前仓库生效的身份（区分 local/global/include）
function git-who() {
echo "─────────────────────────────"
echo "📍 当前仓库生效的 Git 身份："
echo " Name : $(git config user.name)"
echo " Email : $(git config user.email)"
echo ""
echo "🌐 全局默认身份："
echo " Name : $(git config --global user.name)"
echo " Email : $(git config --global user.email)"
echo "─────────────────────────────"
}
# 仅为当前仓库（local）临时设置身份（不影响全局）
function git-set-local() {
echo "请输入本仓库的 Git 用户名："
read name
echo "请输入本仓库的 Git 邮箱："
read email
git config --local user.name "$name"
git config --local user.email "$email"
echo "✅ 已为当前仓库设置本地身份：$name <$email>"
}
执行以下命令使配置生效：
source ~/.zshrc
使用示例
# 切换到工作身份
git-work
# ✅ 已切换到工作身份：张三（实名） <zhangsan@company.com>
# 切换到个人身份
git-personal
# ✅ 已切换到个人身份：YourNickname <your-nickname@gmail.com>
# 查看当前生效身份
git-who
# ─────────────────────────────
# 📍 当前仓库生效的 Git 身份：
# Name : YourNickname
# Email : your-nickname@gmail.com
# ...
方案三：单仓库级别覆盖（最高优先级）
当某个特定仓库需要独立身份时，直接在该仓库内设置 local 配置，优先级高于所有全局/includeIf 配置。
cd /path/to/special-repo
# 仅对当前仓库生效
git config --local user.name "特定身份"
git config --local user.email "special@email.com"
# 查看当前仓库的 local 配置
cat .git/config
三种方案的优先级与对比
优先级（高 → 低）：
局部配置 (.git/config) > includeIf 覆盖 > 全局 ~/.gitconfig 默认值
完整配置汇总（直接复用）
~/.gitconfig
[user]
name = YourNickname
email = your-nickname@gmail.com
[includeIf "gitdir:~/work/"]
path = ~/.gitconfig-work
[includeIf "gitdir:~/company/"]
path = ~/.gitconfig-work
~/.gitconfig-work
[user]
name = 你的真实姓名
email = you@company.com
~/.zshrc 追加部分
function git-work() { git config --global user.name "真实姓名" && git config --global user.email "you@company.com" && echo "✅ 工作身份"; }
function git-personal() { git config --global user.name "YourNickname" && git config --global user.email "you@personal.com" && echo "✅ 个人身份"; }
function git-who() { echo "$(git config user.name) <$(git config user.email)>"; }
常见问题
Q：已经用实名 push 了几个 commit 到公开仓库，怎么补救？
# 修改最近一次 commit 的作者信息
git commit --amend --author="YourNickname <you@personal.com>" --no-edit
# 批量修改历史 commit（谨慎！会重写历史）
git filter-branch --env-filter '
if [ "$GIT_COMMITTER_EMAIL" = "zhangsan@company.com" ]; then
export GIT_COMMITTER_NAME="YourNickname"
export GIT_COMMITTER_EMAIL="you@personal.com"
export GIT_AUTHOR_NAME="YourNickname"
export GIT_AUTHOR_EMAIL="you@personal.com"
fi
' --tag-name-filter cat -- --branches --tags
⚠️
filter-branch会重写所有 commit hash，如果已推送需要git push --force，需谨慎评估影响。
Q：includeIf 配置了但没生效？
检查路径末尾是否有
/：gitdir:~/work/✅ vsgitdir:~/work❌检查路径是否用了
~（需要 Git 2.13+）用
git config --list --show-origin查看配置来源，确认是否被加载
git config --list --show-origin | grep user
# 输出示例：
# file:/Users/you/.gitconfig-work user.name=张三（实名）
总结
对于同时维护工作和开源项目的开发者，推荐：
按目录规划仓库：工作项目统一放
~/work/，个人项目放~/study/或~/opensource/配置
includeIf：一次配置，此后所有新仓库自动匹配，无需任何操作Shell 函数作为应急手段：处理不在规划目录内的临时情况
这套方案可以做到 "克隆即正确"——在对应目录 git clone 后，身份自动正确，永远不会错误提交。