Git 和 GitHub 初学者指南：从安装到第一次推送

Source: Dev.to

开始我在 LUXDevHQ 的 数据科学、分析和人工智能 之旅，就像在学习一种新语言的同时尝试建造一座房子。一路上我发现的最重要的工具之一是 版本控制。

在本指南中，我将带你完成以下内容：

• 设置 Git Bash
• 将 Git 连接到 GitHub
• 掌握关键的 push 和 pull 命令

什么是 Git，为什么它重要？

Git 是一个 版本控制系统 (VCS)。可以把它看作是代码的 存档点系统。

为什么 Git 很重要？

• ⏪ 时间旅行 – 如果你的代码出错，你可以回滚到一个可工作的版本。
• 🤝 协作 – 多个人可以在同一个项目上工作，而不会相互覆盖对方的工作。
• 🧪 实验 – 你可以创建 分支 来尝试新功能，而不会影响主项目。

设置你的环境

步骤 A：安装 Git Bash

1. 前往 Git 并下载适用于你的操作系统（Windows、macOS 或 Linux）的 Git。
2. 运行安装程序。

   💡 小贴士： 大多数选项可以保留默认设置。

3. 安装完成后，打开 Git Bash（它看起来像一个终端窗口）。

步骤 B：配置你的身份

配置全局 Git 设置，让 GitHub 知道是谁在上传代码：

git config --global user.name "Your Name"
git config --global user.email your-email@example.com

保护您的连接：设置 SSH 密钥

使用 SSH 是业界标准。它更安全，并且可以免去每次推送代码时输入密码的麻烦。

步骤 1：生成 SSH 密钥

打开 Git Bash 并运行（将 your_email@example.com 替换为你的 GitHub 邮箱）：

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

• 文件位置： 按 Enter 接受默认路径（~/.ssh/id_ed25519）。
• 密码短语： 为了方便可以留空（如果想要更高安全性，也可以设置）。

步骤 2：将密钥添加到 SSH 代理

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

步骤 3：将公钥添加到 GitHub

将公钥复制到剪贴板：

cat ~/.ssh/id_ed25519.pub

然后：

1. 前往 GitHub → Settings → SSH and GPG keys → New SSH key。
2. 为密钥命名（例如 “My Learning Laptop”），并将密钥粘贴到 Key 框中。

步骤 4：测试连接

ssh -T git@github.com

如果看到 Hi <username>! You've successfully authenticated，说明已成功配置！

导航和创建你的项目

使用 Git Bash 进行导航比使用鼠标更快。运行以下命令来创建你的第一个仓库：

pwd                     # Print Working Directory
cd Desktop              # Go to Desktop
mkdir my-first-repo     # Create folder
cd my-first-repo        # Enter folder

跟踪更改（核心工作流）

在项目文件夹中运行：

git init                         # Start tracking the folder
git status                       # See what Git notices
git add .                        # Stage all changes
git commit -m "My first commit"  # Create a save point

推送代码到 GitHub

步骤 A：在 GitHub.com 上创建仓库

1. 登录 GitHub，点击 + 图标 → New repository。
2. 为仓库命名（例如 my-first-project），并保持 Public。
3. 取消勾选 “Add a README”，以避免冲突。
4. 点击 Create repository。

步骤 B：连接并推送

在 GitHub 设置页面，复制 SSH URL（形如 git@github.com:your-username/repo-name.git），然后运行：

git remote add origin git@github.com:your-username/repo-name.git
git push -u origin main

从 GitHub 拉取代码

如果你在另一台电脑上工作，请使用以下命令下载最新更新：

git pull origin main

持续学习资源

• Official Git Documentation 官方 Git 文档
• GitHub Skills: Interactive Courses GitHub Skills：交互式课程
• Visualizing Git Commands (Game) 可视化 Git 命令（游戏）

结论

恭喜！您已经成功搭建了专业的开发工作流。Git 起初可能有点棘手，但通过练习就会变得驾轻就熟。如果遇到任何问题，欢迎留言并相互帮助！