Sourcetree如何切换不同Git账号提交？

Question

在使用 Sourcetree 进行多项目开发时，常需切换不同的 Git 账号（如个人账号与公司账号）进行代码提交。然而，许多用户发现即使修改了 Sourcetree 中的账户配置，提交记录仍显示旧的用户名和邮箱。这是因为 Git 的用户名和邮箱信息是基于全局或仓库级别的配置，而非仅由 Sourcetree 界面设置决定。若未正确设置本地仓库的 user.name 和 user.email，会导致提交身份错误。如何在 Sourcetree 中为不同项目配置独立的 Git 账号，确保每次提交使用正确的身份？这是开发者频繁遇到的实际问题。

Answer 1

如何在 Sourcetree 中为不同项目配置独立的 Git 账号

1. 问题背景与常见现象

在使用 Sourcetree 进行多项目开发时，开发者常需切换不同的 Git 账号（如个人 GitHub 账号与公司 GitLab 账号）。尽管在 Sourcetree 的“账户设置”中修改了用户名和邮箱，但提交记录仍显示旧的身份信息。这种现象的根本原因在于：Sourcetree 仅作为 Git 的图形化前端工具，其账户配置并不直接控制 Git 提交所使用的 user.name 和 user.email。

Git 的身份信息由以下三个层级决定：

• 系统级（System）：适用于整个操作系统，通常不推荐修改。
• 全局级（Global）：通过 git config --global 设置，影响当前用户所有仓库。
• 本地仓库级（Local）：通过 git config --local 设置，仅作用于当前项目。

2. 根本原理分析

当执行 git commit 时，Git 按照优先级查找配置：

1. 先检查当前仓库的 local 配置；
2. 若未设置，则回退到 global 配置；
3. 最后才是 system 级别。

因此，即使你在 Sourcetree 中绑定了新账号，如果该仓库没有设置 local 的 user.name 和 user.email，Git 仍会使用全局配置进行提交。

配置级别	命令示例	配置文件路径	适用范围
Local	git config --local user.name "Alice"	.git/config	当前仓库
Global	git config --global user.name "Bob"	~/.gitconfig	当前用户所有仓库
System	git config --system user.name "Charlie"	/etc/gitconfig	系统所有用户

3. 解决方案：为每个项目设置独立的 Local 账号

为了确保每个项目使用正确的提交身份，应在进入项目目录后手动设置 local 级别的用户名和邮箱。

# 进入公司项目目录
cd /path/to/company/project
git config --local user.name "张伟"
git config --local user.email "[e-mail]"

# 进入个人开源项目
cd /path/to/personal/project
git config --local user.name "Wei Zhang"
git config --local user.email "[e-mail]"
    

设置完成后，可通过以下命令验证：

git config --get user.name
git config --get user.email

4. Sourcetree 中的实际操作流程

虽然 Sourcetree 不自动同步账户到 local 配置，但可以辅助完成设置：

1. 打开 Sourcetree，右键点击目标仓库 → “Repository Settings”
2. 在左侧选择 “Settings” 选项卡
3. 找到 “Default username and email” 区域
4. 输入该项目对应的用户名和邮箱
5. 点击 “OK” 后，Sourcetree 会自动执行 git config --local 命令
6. 后续提交将使用此身份

5. 自动化脚本建议（提升效率）

对于频繁切换项目的高级开发者，可编写 Shell 脚本或使用 Git Hook 实现自动化身份识别。

#!/bin/bash
# auto_set_git_identity.sh
PROJECT_PATH=$(pwd)

if [[ "$PROJECT_PATH" == *"/company/"* ]]; then
    git config --local user.name "张伟"
    git config --local user.email "[e-mail]"
elif [[ "$PROJECT_PATH" == *"/personal/"* ]]; then
    git config --local user.name "Wei Zhang"
    git config --local user.email "[e-mail]"
else
    echo "Unknown project type, using global identity."
fi
    

6. 多账号 SSH 密钥管理（补充要点）

除了用户名和邮箱，还需注意 SSH 密钥的匹配问题。不同 Git 服务应使用不同的密钥对，并在 ~/.ssh/config 中配置 Host 别名：

# ~/.ssh/config
Host github-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_personal

Host gitlab-company
    HostName gitlab.company.com
    User git
    IdentityFile ~/.ssh/id_rsa_company
    

对应仓库的 remote URL 应使用别名：

git remote set-url origin git@github-personal:username/repo.git

7. 流程图：多账号切换逻辑判断

graph TD
            A[开始提交代码] --> B{是否设置了 local 用户信息?}
            B -- 是 --> C[使用 local user.name/email]
            B -- 否 --> D{是否设置了 global 用户信息?}
            D -- 是 --> E[使用 global user.name/email]
            D -- 否 --> F[使用 system 或默认值]
            C --> G[生成正确提交记录]
            E --> G
            F --> G

8. 常见误区与排查方法

以下是实际开发中常见的错误场景及排查方式：

• 误以为 Sourcetree 账户 = Git 提交身份：需明确区分界面账户与底层 Git 配置。
• 忘记检查 .git/config 文件：可通过 cat .git/config 查看 local 设置。
• 全局配置覆盖 local 设置：确认未在脚本或环境变量中重复设置 global。
• IDE 缓存旧身份：重启 IDE 或清除缓存以刷新状态。
• 跨平台差异（Windows vs macOS/Linux）：注意路径分隔符与 home 目录位置。

9. 最佳实践建议

针对有 5 年以上经验的开发者，推荐以下工程化做法：

1. 建立项目命名规范（如 ~/projects/company/ 与 ~/projects/personal/）
2. 编写初始化脚本，在克隆新项目后自动设置身份
3. 使用 Git Template 或 init.templateDir 统一初始配置
4. 结合 CI/CD 检查提交邮箱是否符合组织策略
5. 定期审计历史提交记录：git log --pretty=format:"%an <%ae>" | sort -u
6. 使用 git config --list --show-origin 查看所有配置来源
7. 避免在团队项目中依赖 global 配置
8. 文档化团队的 Git 身份管理规范
9. 培训新人理解 Git 配置层级机制
10. 利用 pre-commit Hook 强制校验提交身份