mac git@gitlab.com: Permission denied (publickey).

### 解决 Mac 上 Git 访问 GitLab 时遇到的 `Permission denied (publickey)` 错误

当尝试通过 SSH 协议连接到 GitLab 并收到 `git@gitlab.com: Permission denied (publickey)` 的错误提示时，这通常意味着客户端无法成功验证用户的 SSH 密钥。以下是详细的解决方案：

#### 1. 检查现有的 SSH 密钥
首先确认本地是否存在有效的 SSH 私钥和公钥对。默认情况下，SSH 密钥存储在 `~/.ssh` 文件夹下。

ls -al ~/.ssh

如果存在名为 `id_rsa` 和 `id_rsa.pub` 或其他类似的密钥文件，则说明已经创建过 SSH 密钥；如果没有发现任何密钥文件，则需要继续下一步来生成新的 SSH 密钥[^3]。

#### 2. 创建一个新的 SSH 密钥
对于尚未拥有 SSH 密钥的情况，可以运行如下命令以基于电子邮件地址创建一对新的 RSA 类型的 SSH 密钥（建议替换为你实际使用的邮箱）:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

此操作会引导用户指定保存位置以及设置密码保护（可选）。完成后会在终端显示新生成的私钥路径及其对应的指纹信息[^4]。

#### 3. 将公钥添加至 GitLab 帐号
复制刚刚生成或已有的 `.pub` 文件中的内容，并将其粘贴到个人 GitLab 设置页面的安全区域内的 SSH Keys 字段内完成绑定过程。具体步骤如下：
- 登录 GitLab；
- 进入 User Settings -> SSH Keys；
- 点击 Add SSH Key；
- 把之前获取的内容填入 Title 及 Key 文本框并提交保存[^1]。

#### 4. 测试 SSH 连接
为了确保一切正常工作，在终端输入下面这条指令来进行测试性的远程登录请求：

ssh -T git@gitlab.com

如果配置无误的话应该能看到一条欢迎消息表示身份认证成功[^2]。

#### 5. 更新全局 Git 用户名与邮箱
最后一步是为了让 Git 能够识别当前计算机上的作者信息而执行这两条命令更新全局用户名及电邮地址：

git config --global user.email "your_email@example.com"

以上措施能够有效解决大多数关于 macOS 下利用 Git 工具克隆仓库时报出 `Permission denied (publickey)` 的情况。当然也有可能是因为网络环境或者其他特殊原因引起的问题，这时就需要进一步排查了。