目录

1. 第一部分：准备工作

   
   （图片来源网络，侵删）
   • 1 什么是 Git 和 GitHub？
   • 2 注册 GitHub 账号
   • 3 安装 Git
   • 4 安装 GitHub Desktop (官方推荐的 Mac 客户端)
   • 5 配置 Git (首次必做)

2. 第二部分：GitHub Desktop 核心操作

   • 1 克隆仓库：将别人的项目下载到本地
   • 2 创建并推送你的第一个仓库
   • 3 修改项目并提交更改
   • 4 推送更改到 GitHub
   • 5 从 GitHub 拉取最新更改

3. 第三部分：进阶与协作

   • 1 创建分支
   • 2 发起 Pull Request (PR)：贡献代码的标准流程
   • 3 管理 Issues：跟踪任务和 Bug

4. 第四部分：常用术语速查表

第一部分：准备工作

1 什么是 Git 和 GitHub？

• Git: 是一个免费、开源的分布式版本控制系统，你可以把它想象成一个“超级U盘”或“项目时光机”，它能记录你对项目文件的所有修改历史，让你可以随时回溯到任何一个时间点的版本，它还能让你和团队成员在不同电脑上协作开发，而不会互相覆盖对方的代码。
• GitHub: 是一个基于 Git 的代码托管平台和社区，你可以把它想象成一个“云盘”，专门用来存放 Git 仓库，它提供了网页界面，让你可以方便地浏览代码、管理项目、追踪问题，并与全球的开发者协作。

简单比喻：

• Git 是你车里的发动机和变速箱，负责驱动和变速。
• GitHub 是一个大型赛车场和维修站，让你能展示你的车（项目），和其他车手（开发者）交流，还能获得专业服务（协作工具）。

2 注册 GitHub 账号

1. 打开浏览器,访问 github.com。
2. 点击右上角的 Sign up。
3. 按照提示输入用户名、邮箱和密码，邮箱最好使用 Gmail 或 Outlook 等主流邮箱，方便接收通知。
4. 验证邮箱,完成注册。

3 安装 Git

虽然 GitHub Desktop 会自带一个 Git，但为了确保命令行工具的可用性，我们推荐单独安装。

1. 访问 Git 官方下载页面：https://git-scm.com/download/mac
2. 网站会自动检测你的 macOS 版本并提供下载链接，下载 .dmg 安装包。
3. 打开下载的 .dmg 文件，按照提示一步步安装即可，安装过程很简单，一路点击 "Continue" -> "Agree" -> "Install" 即可。
4. 安装完成后,打开 终端（可以在 应用程序 -> 实用工具 里找到，或使用 Spotlight 搜索 Terminal），输入以下命令检查是否安装成功：

   git --version

   如果看到类似 git version 2.x.x 的输出，说明安装成功。

4 安装 GitHub Desktop (官方推荐的 Mac 客户端)

对于 Mac 用户，尤其是初学者，GitHub Desktop 是最佳选择，它图形化了复杂的 Git 命令，让操作变得直观。

1. 访问 GitHub Desktop 官方下载页面：https://desktop.github.com/
2. 点击 "Download GitHub Desktop"，下载 .dmg 文件。
3. 打开下载的文件,将 GitHub Desktop 图标拖拽到 应用程序 文件夹。
4. 从 应用程序 中启动 GitHub Desktop。
5. 首次启动时,它会提示你登录 GitHub 账号，使用你在 1.2 步注册的账号登录。
6. 登录成功后,它会引导你配置 Git，它会自动帮你填写用户名和邮箱，请确保这里的邮箱与你注册 GitHub 账号时使用的邮箱一致，然后点击 "Continue"。

5 配置 Git (首次必做)

虽然 GitHub Desktop 会帮你配置，但为了完整性，我们也在命令行中配置一次。

打开 终端，输入以下两行命令，把 Your Name 和 your_email@example.com 替换成你自己的信息。

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

这个配置会告诉 Git，你是谁，当你提交代码时，就会记录下这些信息。

第二部分：GitHub Desktop 核心操作

1 克隆仓库：将别人的项目下载到本地

如果你想参与一个别人的开源项目,或者只是想看看某个项目的代码，你需要“克隆”它。

1. 在 GitHub 网站上，打开你想要的项目页面（https://github.com/facebook/react）。
2. 点击绿色的 Code 按钮。
3. 在弹出的窗口中,复制 HTTPS 链接。
4. 打开 GitHub Desktop。
5. 点击左上角的 File -> Clone Repository...。
6. 在 "URL" 输入框中，粘贴你刚刚复制的 HTTPS 链接。
7. 在 "Local path" 中，选择一个你想存放这个项目的本地文件夹位置。
8. 点击 Clone，稍等片刻，项目就会被完整地下载到你的 Mac 上。

2 创建并推送你的第一个仓库

如果你想创建一个全新的项目并上传到 GitHub，可以这样做：

1. 在 GitHub 网站上，点击右上角的 号，选择 New repository。
2. 填写仓库名称（my-awesome-project），可以添加描述。
3. 选择 Public（公开）或 Private（私有）。
4. 不要勾选 "Add a README file"，因为我们后面会用 GitHub Desktop 来创建。
5. 点击 Create repository。
6. 现在你会看到一个空仓库的页面,找到 "…or push an existing repository from the command line" 这部分，复制 git remote add origin ... 这一行，这行命令包含了你的仓库地址。
7. 打开 GitHub Desktop，点击左上角的 File -> Add Local Repository...。
8. 选择你已经在本地创建好的项目文件夹。
9. 在弹出的窗口中,会显示 "No remote linked yet"，点击 Choose a remote...，然后选择 New remote...。
10. 在 "Name" 中输入 origin（这是标准名称），在 "URL" 中粘贴你刚刚复制的仓库地址。
11. 点击 Add remote。
12. 你的本地仓库已经和 GitHub 仓库关联起来了，在 GitHub Desktop 左下角，你会看到 Current repository 已经是你的新仓库。
13. 在 Summary 输入框中，写下你的提交说明，"Initial commit"。
14. 点击 Commit to main，这会将你本地的初始文件（.gitignore）提交到本地仓库。
15. 提交成功后,点击右上角的 Push origin 按钮，你的代码就会被上传到 GitHub。

恭喜！你的第一个项目已经成功托管在 GitHub 上了！

3 修改项目并提交更改

这是最常用的日常操作。

1. 用你喜欢的编辑器（如 VS Code, Sublime Text）打开你通过克隆或创建方式得到的本地项目文件夹。
2. 修改任意一个文件,比如在 README.md 里加一行字 "Hello, GitHub!"。
3. 保存你的修改。
4. 回到 GitHub Desktop，你会看到左侧的 Changes 列表中，那个被修改的文件出现了。
5. 在 Summary 输入框中，为这次修改写一个简短的说明，"Add greeting to README"。
6. （可选）在 Description 输入框中，可以写更详细的说明。
7. 点击 Commit to main，这会将你的修改保存到本地的 Git 历史中。

注意： 此时你的修改只在你的 Mac 上，还没有上传到 GitHub。

4 推送更改到 GitHub

1. 提交之后,切换到 GitHub Desktop 的 History 标签页。
2. 你会看到刚才的提交记录。
3. 点击右上角的 Push origin 按钮。
4. 稍等片刻,GitHub Desktop 会将你的新提交同步到 GitHub 服务器上。
5. 回到 GitHub 网站的项目页面，刷新一下，你会发现 README.md 文件已经被更新了。

5 从 GitHub 拉取最新更改

如果你和别人在同一个项目上工作,或者你在另一台电脑上修改了代码，你需要将最新的版本同步到当前电脑。

1. 在 GitHub Desktop 界面，点击左上角的 Current repository 下拉菜单，选择你想要同步的仓库。
2. 点击右上角的 Fetch origin 按钮。
   • Fetch (抓取)：只从 GitHub 下载最新的信息，但不合并你的本地文件，这是一个安全的操作，你可以先看看别人做了什么。
3. 如果确认要合并最新的更改,点击 Pull origin 按钮。
   • Pull (拉取)：相当于 Fetch + Merge，它会从 GitHub 下载最新代码，并自动合并到你的本地项目中，如果有冲突，它会提示你。

第三部分：进阶与协作

1 创建分支

分支是 Git 的核心功能之一，它允许你在不影响主项目（main 或 master 分支）的情况下，独立开发新功能或修复 Bug。

1. 在 GitHub Desktop 的左下角，点击 Current branch 旁边的下拉箭头。
2. 选择 New branch...。
3. 输入新分支的名称,feature-login-page，然后点击 Create branch。
4. 你就在这个新分支上了,你可以像往常一样修改文件、提交更改，这些操作都不会影响到 main 分支。
5. 当你的功能开发完成后,就可以将这个分支合并回 main 分支（通常通过 Pull Request）。

2 发起 Pull Request (PR)：贡献代码的标准流程

PR 是向项目作者提出“请把我做的这些更改合并到你的项目中”的请求。

1. 假设你在 feature-login-page 分支上完成了开发，并且已经 Push 到了 GitHub。
2. 回到 GitHub 网站的项目页面。
3. 你会看到一个提示 "Your branch is ahead of 'main' by 1 commit." 的黄色条框，点击 Compare & pull request。
4. 进入 PR 页面：
   • base: 选择 main (目标分支)。
   • compare: 选择 feature-login-page (你的分支)。
   • 在 Title 中为你的 PR 命名。
   • 在 Leave a comment 中详细描述你的修改内容。
5. 点击 Create pull request。
6. 项目作者会收到通知,他会审查你的代码，如果没问题，他会点击 Merge，你的代码就正式成为项目的一部分了。

3 管理 Issues：跟踪任务和 Bug

Issues 是一个任务跟踪系统，用于记录 Bug、功能请求、任务等。

1. 在 GitHub 项目页面，点击 Issues
2. 点击 New issue。
3. 和详细描述,可以为 Issue 打上 bug, enhancement 等标签。
4. 点击 Submit new issue。
5. Issues 可以被指派给团队成员，也可以被关联到某个 Pull Request，是项目管理的重要工具。