如何使用 Git 和 SSH 将项目推送到 GitHub

目录

1. 前提条件

2. 安装 Git

3. 生成 SSH 密钥

生成 SSH 密钥的步骤：

添加 SSH 密钥到 SSH Agent：

4. 将 SSH 密钥添加到 GitHub

5. 配置 Git 用户信息

6. 将本地代码推送到 GitHub

1. 初始化本地 Git 仓库

2. 添加远程仓库

3. 添加文件并提交

4. 推送到 GitHub

7. 常见问题及解决方法

1. GitHub 提示权限拒绝 (Permission denied)

2. 连接 GitHub 超时或被重置

3. 无法解析主机名 (Could not resolve hostname)

8. 总结

---

1. 前提条件

在开始之前，你需要确保：

• 你已经注册了 GitHub 账号。
• 本地已经安装了 Git 工具，或者按照后面的步骤进行安装。

---

2. 安装 Git

如果你还没有安装 Git，可以按照以下步骤操作：

• 访问 Git 官网 并下载适合你操作系统的版本。
• 安装过程中，建议保留默认设置，除非你有特殊需求。

安装完成后，打开命令行（Windows 用户可以使用 Git Bash），输入以下命令来检查是否安装成功：

git --version

你应该会看到类似以下输出：

git version 2.x.x

---

3. 生成 SSH 密钥

为了能够通过 SSH 连接到 GitHub，我们首先需要生成 SSH 密钥。SSH 是一种安全协议，用于在远程服务器之间进行加密通信。

生成 SSH 密钥的步骤：

1. 打开 Git Bash 或终端，执行以下命令生成 SSH 密钥：

   ssh-keygen -t ed25519 -C "your_email@example.com"

   其中 your_email@example.com 是你注册 GitHub 时使用的邮箱。

2. 当提示 Enter file in which to save the key 时，直接按回车键，使用默认位置。

3. 如果不想为密钥设置密码，可以在 Enter passphrase 提示时直接按回车键。

4. 生成密钥后，你会看到类似以下的输出：

   Your identification has been saved in /c/Users/YourName/.ssh/id_ed25519 Your public key has been saved in /c/Users/YourName/.ssh/id_ed25519.pub

添加 SSH 密钥到 SSH Agent：

在生成密钥后，你需要将其添加到 SSH Agent 中，以便自动管理密钥。执行以下命令：

eval "$(ssh-agent -s)" ssh-add ~/.ssh/id_ed25519

---

4. 将 SSH 密钥添加到 GitHub

现在我们需要将刚才生成的公钥添加到 GitHub 中：

1. 打开 Git Bash 或终端，执行以下命令查看公钥内容：

   cat ~/.ssh/id_ed25519.pub

   这将显示你生成的公钥内容，复制这段内容。

2. 登录到 GitHub，点击右上角的头像，选择 Settings。

3. 在左侧菜单中，点击 SSH and GPG keys，然后点击 New SSH key。

4. 在 Title 栏中为你的密钥命名（例如 "My Laptop SSH Key"），然后将公钥粘贴到 Key 栏中。

5. 点击 Add SSH key。

至此，你已经成功将公钥添加到了 GitHub。

---

5. 配置 Git 用户信息

在推送代码之前，你需要配置 Git 的用户信息。执行以下命令：

git config --global user.name "Your Name"

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

Your Name 是你的名字，your_email@example.com 是你注册 GitHub 的邮箱。

---

6. 将本地代码推送到 GitHub

1. 初始化本地 Git 仓库

进入你想要推送的项目文件夹，执行以下命令来初始化 Git 仓库：

git init

2. 添加远程仓库

假设你已经在 GitHub 上创建了一个新的仓库（比如 yunstudy），你需要将本地仓库与 GitHub 仓库关联起来：

git remote add origin git@github.com:yourusername/yunstudy.git

将 yourusername 和 yunstudy 替换为你的 GitHub 用户名和仓库名称。

3. 添加文件并提交

将文件添加到 Git 仓库并进行提交：

git add . git commit -m "Initial commit"

4. 推送到 GitHub

现在可以将本地代码推送到 GitHub：

git push -u origin main

如果一切顺利，你应该会看到类似以下的输出：

Enumerating objects: 84, done. Counting objects: 100% (84/84), done. Delta compression using up to 16 threads Compressing objects: 100% (68/68), done. Writing objects: 100% (84/84), 101.34 KiB | 338.00 KiB/s, done. Total 84 (delta 2), reused 0 (delta 0), pack-reused 0 remote: Resolving deltas: 100% (2/2), done. To github.com:yourusername/yunstudy.git * [new branch] main -> main branch 'main' set up to track 'origin/main'.

7. 常见问题及解决方法

1. GitHub 提示权限拒绝 (Permission denied)

如果你在推送代码时看到类似 Permission denied (publickey) 的错误，可能是 SSH 配置不正确。请确保：

• 你的 SSH 公钥已正确添加到 GitHub。
• SSH Agent 正在运行，并且私钥已添加到 Agent。

2. 连接 GitHub 超时或被重置

如果你在测试 SSH 连接时遇到 Connection reset by host，请尝试通过端口 443 连接：

ssh -T -p 443 git@ssh.github.com

3. 无法解析主机名 (Could not resolve hostname)

如果你看到类似 Could not resolve hostname 的错误，检查你的网络配置，确保 DNS 设置正确，并且能够连接到 GitHub 服务器。

---

8. 总结

通过本文，你学习了如何生成 SSH 密钥、将其添加到 GitHub，并将本地代码推送到 GitHub 仓库。SSH 是一个非常安全的认证方式，能够有效保护你和远程仓库之间的通信。

现在，你已经掌握了 Git 和 GitHub 的基础操作，接下来你可以更好地管理和分享你的代码。