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

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 "[email protected]"其中 [email protected] 是你注册 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 "[email protected]"

Your Name

是你的名字，

[email protected]

是你注册 GitHub 的邮箱。

6. 将本地代码推送到 GitHub

1. 初始化本地 Git 仓库

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

git init

2. 添加远程仓库

假设你已经在 GitHub 上创建了一个新的仓库（比如

yunstudy

），你需要将本地仓库与 GitHub 仓库关联起来：

git remote add origin [email protected]:yourusername/yunstudy.git

将

yourusername

和

yunstudy

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

3. 添加文件并提交

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

git add .

git commit -m "Initial commit"

git branch -M main

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 [email protected]

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

如果你看到类似

Could not resolve hostname

的错误，检查你的网络配置，确保 DNS 设置正确，并且能够连接到 GitHub 服务器。

8. 总结

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

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