macOS下Sourcetree关联GitHub账号的终极避坑指南（含Token生成与HTTPS配置）

macOS下Sourcetree关联GitHub账号的终极避坑指南（含Token生成与HTTPS配置）

如果你是一名在macOS上工作的开发者，那么Sourcetree很可能是你管理Git仓库的得力助手。它直观的图形界面让复杂的Git操作变得简单，但当你试图将它与GitHub这个全球最大的代码托管平台连接时，却可能遭遇一系列令人沮丧的“拦路虎”：无限弹出的密码认证框、神秘的连接失败提示，或者干脆就是一片空白。这感觉就像手握一把精密的钥匙，却怎么也打不开自家的大门。

问题的根源，往往在于认证方式的变迁。GitHub早已弃用了传统的“用户名+密码”认证，转而拥抱更安全的SSH密钥和Personal Access Token（个人访问令牌）。然而，许多教程和工具的默认配置并未完全跟上这一变化，导致在macOS的特定环境下，Sourcetree与GitHub的“握手”过程频频出错。本文将从一个资深开发者的实战经验出发，为你梳理出一条清晰、可靠的配置路径。我们不仅会解决那些恼人的弹窗问题，还会深入探讨如何利用HTTPS协议和Token，构建一个稳定、高效的开发工作流。无论你是刚接触Git的新手，还是被这个问题困扰已久的老手，这份指南都将带你绕过所有已知的“坑”，让Sourcetree与GitHub的协作变得丝滑顺畅。

1. 环境准备与问题诊断

在开始任何配置之前，确保你的“作战环境”是清晰且干净的，这能避免很多由历史遗留问题引发的冲突。首先，确认你的软件版本。虽然本文的方法具有较广的兼容性，但了解基础环境有助于排查特定版本的问题。

• macOS: 从Catalina到最新的Sonoma，核心步骤基本一致。系统权限管理（如钥匙串访问）的细微差异可能会影响认证流程。
• Sourcetree: 建议使用较新的版本（如4.x及以上），旧版本可能对新的GitHub认证协议支持不完善。
• Git: macOS通常自带Git，但版本可能较旧。可以通过 git --version 在终端查看。建议通过Homebrew安装或更新至较新版本，以获得更好的稳定性和功能支持。

很多人在关联失败后，会反复尝试，导致系统中堆积了无效或过期的认证凭据。Sourcetree和Git都会在本地缓存这些信息，它们就像错误的钥匙，会优先被使用，从而阻止正确的认证流程。因此，我们的第一步是进行“大扫除”。

彻底清理旧的GitHub认证缓存：

首先，请完全退出Sourcetree（使用 Command + Q，而不仅仅是关闭窗口）。然后，打开终端（Terminal），执行以下命令：

# 删除Sourcetree中缓存的与GitHub相关的所有认证信息
rm -rf ~/Library/Application\ Support/SourceTree/*github.com*

# 可选但推荐：同时清理Git的全局凭据缓存（特别是如果你曾尝试过其他方式连接）
git credential-osxkeychain erase
host=github.com
protocol=https

注意：第二条命令是一个交互式命令。输入第一行 git credential-osxkeychain erase 后回车，然后依次输入 host=github.com 和 protocol=https，每行输入后回车，最后在一个空行上按 Control + D 结束输入。这会从macOS钥匙串中删除GitHub的HTTPS凭据。

完成清理后，我们还需要检查并正确配置Git的全局设置，这是确保后续所有Git操作（包括Sourcetree内部的）都使用正确协议和代理（如果需要）的基础。

2. 核心配置：Git全局设置与HTTPS代理

Git的行为很大程度上由它的配置文件控制。对于macOS用户，最关键的是全局配置文件 ~/.gitconfig。正确的配置能解决一大半的网络和认证问题。

用你喜欢的文本编辑器（如VSCode、Vim、Nano）打开这个文件：

# 使用VSCode打开
code ~/.gitconfig

# 或使用nano（