当 GitLab 账号密码更改,需要在 Mac 的 SourceTree 中修改密码
✅ 一、用户名/密码改变:清除旧的凭据
SourceTree 在 macOS 上通常使用 Keychain Access(钥匙串) 来保存 HTTPS 的用户名和密码。
方法:使用“钥匙串访问”删除旧凭据
- 打开 "应用程序" → "实用工具" → "钥匙串访问"(Keychain Access)
- 在右上角搜索框中输入:
gitlab或- 旧的 GitLab 域名(如
gitlab.oldcompany.com)
- 找到类型为 "互联网密码" 的条目,与 GitLab 相关的
- 右键删除它(或按 Delete)
⚠️ 删除后,下次拉取/推送时会重新提示输入用户名和密码。
✅ 二、如果 GitLab 地址变了: 修改远程仓库地址 (如果没变可跳过这一步)
- 打开 SourceTree
- 在左侧选择你的项目仓库
- 点击顶部菜单栏的 "设置"(Settings) 或右键仓库 → "Repository Settings"
- 在 "Remotes" 选项卡中,找到
origin(或其他远程名) - 修改 "URL" 字段为新的 GitLab 地址,例如: gitlab.newcompany.com/username/pr…
- 点击 Save
✅ 三、重新输入用户名和密码
- 回到 SourceTree
- 尝试执行一次 Pull / Push / Fetch
- 会弹出窗口让你输入:
- Username
- Password(或 Personal Access Token)
🔐 注意:如果 GitLab 启用了 2FA 或已禁用密码登录,必须使用 Personal Access Token 代替密码。
如何生成 Personal Access Token(GitLab):
- 登录新的 GitLab 地址
- 点头像 → Settings → Access Tokens
- 创建一个 Token,勾选
read_repository和write_repository - 复制生成的 Token(只显示一次)
然后在 SourceTree 弹出的登录框中:
- Username:你的 GitLab 用户名
- Password:粘贴刚才的 Token
✅ 四、可选:改用 SSH(推荐更安全)
如果你不想每次都处理密码或 Token,建议切换到 SSH:
- 生成 SSH 密钥(如果还没有):
ssh-keygen -t ed25519 -C "your_email@example.com" - 将公钥(
~/.ssh/id_ed25519.pub)内容添加到 GitLab 的: Settings → SSH Keys - 将远程 URL 改为 SSH 格式: git@gitlab.newcompany.com:username/project.git
- 在 SourceTree 的仓库设置中更新 URL 为 SSH 地址
总结
| 步骤 | 操作 |
|---|---|
| 1 | 更新远程仓库 URL |
| 2 | 用“钥匙串访问”删除旧凭据 |
| 3 | 下次操作时输入新用户名 + 密码(或 Token) |
| 4 | 推荐使用 SSH 避免频繁输入 |