Git 权限被拒绝（publickey）

在本文中，我们将介绍 Git 中的权限被拒绝（publickey）错误，并提供解决该错误的方法和示例说明。

阅读更多：Git 教程

什么是 “权限被拒绝（publickey）” 错误？

当您使用 Git 进行远程操作（如克隆仓库、推送更改等）时，您可能会遇到 “权限被拒绝（publickey）” 错误。这通常是由于您的 SSH 密钥未被正确设置或无法被识别所导致的。SSH 密钥用于验证您的身份并允许您与远程服务器进行安全通信。

如何解决 “权限被拒绝（publickey）” 错误？

以下是几种常见的解决方法，您可以根据自己的情况选择适合的方法。

方法一：生成并添加 SSH 密钥

1. 首先，检查您是否已经生成了 SSH 密钥。在终端中运行以下命令：

   ls -al ~/.ssh
   

   如果出现了 id_rsa 和 id_rsa.pub 文件，则表示您已经有一个 SSH 密钥对。否则，请继续以下步骤生成 SSH 密钥。

2. 生成 SSH 密钥对。在终端中运行以下命令，并按照提示输入您的电子邮件地址：

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

3. 您将被要求选择密钥的保存位置和文件名，并设置一个密码来保护您的私钥。按照提示进行设置。

4. 添加 SSH 密钥到 SSH 代理。在终端中运行以下命令以启动 SSH 代理：

   eval "$(ssh-agent -s)"
   

5. 将生成的密钥添加到 SSH 代理中：

   ssh-add ~/.ssh/id_rsa
   

6. 最后，将公钥添加到您的 Git 托管服务提供商（如 GitHub、GitLab）的设置中。复制公钥的内容：

   cat ~/.ssh/id_rsa.pub
   

   然后将其粘贴到托管服务提供商的相应设置页面中。

方法二：使用 HTTPS 进行远程操作

如果您无法解决 SSH 密钥问题，或者您不打算使用 SSH 密钥进行身份验证，可以选择使用 HTTPS 进行远程操作。

1. 将远程仓库的 HTTPS URL 复制到剪贴板。

2. 在终端中进入您想要克隆或推送的本地仓库目录，并使用以下命令进行克隆或推送：

   git clone https://github.com/username/repo.git
   git push https://github.com/username/repo.git
   

请注意，使用 HTTPS 进行远程操作需要您在每次操作时输入用户名和密码。

方法三：检查主机密钥的正确性

在某些情况下，权限被拒绝错误可能是由于远程服务器的主机密钥发生了变化所致。您可以尝试删除本地保存的主机密钥，并重新连接远程服务器以重新验证和保存新的主机密钥。

示例说明

以下是两个示例，展示了如何解决权限被拒绝（publickey）错误。

示例一：生成并添加 SSH 密钥

1. 在终端中运行 ssh-keygen -t rsa -b 4096 -C "your_email@example.com"。

2. 按照提示设置密钥保存位置、文件名和密码。

3. 运行 eval "$(ssh-agent -s)" 启动 SSH 代理。

4. 运行 ssh-add ~/.ssh/id_rsa 将生成的 SSH 密钥添加到代理中。

5. 复制 ~/.ssh/id_rsa.pub 中的公钥内容。

6. 在 GitHub 的设置页面中添加公钥。

示例二：使用 HTTPS 进行远程操作

1. 复制远程仓库的 HTTPS URL。

2. 在终端中运行 git clone https://github.com/username/repo.git 进行克隆。

请注意，对于每次克隆或推送操作，您都需要输入用户名和密码。

总结

本文介绍了 Git 中的 “权限被拒绝（publickey）” 错误，并提供了几种解决方案。您可以生成并添加 SSH 密钥，使用 HTTPS 进行远程操作，或者检查主机密钥的正确性。通过正确解决此错误，您将能够顺利进行 Git 远程操作，并与团队成员协作开发项目。