目录

1. 准备工作
   • 第一步：安装 Xcode Command Line Tools
   • 第二步：安装 Homebrew (可选,但推荐)
   • 第三步：安装 Git
2. 配置 Git (至关重要)
   • 设置你的用户名和邮箱
   • 配置 SSH Key (免密登录,强烈推荐)
3. 创建 GitHub 账号
4. 创建并上传你的第一个仓库
   • 在网页端创建，然后克隆到本地
   • 在本地创建，然后推送到 GitHub (更常用)
5. 常用 Git 命令详解
6. 日常协作流程：Fork & Pull Request (PR)
7. 常用 GUI 工具推荐
8. 总结与最佳实践

准备工作

在开始之前，你的 Mac 需要安装 Git，Git 是一个版本控制系统，是 GitHub 的基础。

第一步：安装 Xcode Command Line Tools

这是最简单、最官方的安装 Git 的方法,因为它会帮你处理好大部分依赖。

1. 打开 终端 (Terminal)，你可以在 应用程序 -> 实用工具 里找到它，或者使用 Spotlight 搜索 (按 Cmd + 空格键) 输入 Terminal 并回车。
2. 在终端中输入以下命令并回车：

   xcode-select --install

3. 系统会弹出一个安装窗口，点击“安装”并同意条款，等待安装完成，这个包不仅包含 Git，还包含了很多 macOS 开发者工具。

第二步：安装 Homebrew (可选)

Homebrew 是 macOS 上的包管理器，如果你未来需要安装其他开发工具 (如 Node.js, Python 等)，它会非常有用，即使你只用第一步安装了 Git，了解 Homebrew 也没有坏处。

1. 打开终端，访问 Homebrew 官方安装页面获取最新命令：brew.sh
2. 官网首页会显示一个安装命令，类似这样：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. 复制这个命令，在终端中粘贴并回车，然后按照提示输入你的 Mac 密码,等待安装完成。
4. 安装完成后，你可以用 Homebrew 来安装 Git (虽然第一步已经装好了)：

   brew install git

第三步：验证 Git 安装

无论你用哪种方法安装了 Git,都需要验证一下。

在终端中输入：

git --version

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

配置 Git

这是必须的一步，用于告诉 Git 你是谁，每次你提交代码时,这些信息都会被记录下来。

设置你的用户名和邮箱

打开终端，输入以下命令（请将 Your Name 和 your.email@example.com 替换成你自己的信息）：

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

git config --global user.name "Zhang San"
git config --global user.email "zhangsan@example.com"

小贴士：

• --global 参数表示这个配置会作用于你系统上的所有仓库，你也可以为单个项目单独配置（去掉 --global）。
• 你可以通过 git config --list 命令查看所有当前的配置。

配置 SSH Key (免密登录，强烈推荐)

每次向 GitHub 提交代码时，如果你不使用 SSH，就需要输入用户名和密码，配置 SSH Key 后，可以实现安全、免密的远程通信。

1. 检查是否已有 SSH Key 在终端中输入：

   ls -al ~/.ssh

   如果看到 id_rsa.pub 或 id_ed25519.pub 文件，说明你已经有一个 SSH Key 了，可以直接跳到第 4 步，如果没有,请继续。

2. 生成新的 SSH Key 在终端中输入以下命令（将你的邮箱地址替换成你在 GitHub 使用的邮箱）：

   ssh-keygen -t ed25519 -C "your.email@example.com"

   • -t ed25519 是推荐使用的新一代加密算法，比 rsa 更安全。
   • 系统会提示你“Enter a file in which to save the key...”，直接按回车键即可（使用默认路径）。
   • 接着会提示你“Enter passphrase”（设置一个密码），你可以设置也可以直接按回车跳过（不设置密码更方便，但安全性稍低）。

3. 启动 SSH Agent 并添加你的 Key

   # 启动 SSH Agent
   eval "$(ssh-agent -s)"
   # 添加你的私钥到 Agent
   ssh-add ~/.ssh/id_ed25519

4. 将 SSH Key 复制到剪贴板 这是关键一步，你需要把公钥内容告诉 GitHub。

   pbcopy < ~/.ssh/id_ed25519.pub

   这个命令会自动将公钥内容复制到你的剪贴板,你无需手动复制。

5. 在 GitHub 上添加 SSH Key

   • 登录你的 GitHub 账号。
   • 点击右上角的头像，选择 Settings。
   • 在左侧菜单栏最下方找到并点击 SSH and GPG keys。
   • 点击 New SSH key 按钮。
   • 在 "Title" 框中给你的 Key 起个名字，"My MacBook Pro"。
   • 在 "Key" 框中，直接粘贴 你在第 4 步中复制到剪贴板的内容。
   • 点击 Add SSH key 按钮。

6. 测试连接 在终端中输入：

   ssh -T git@github.com

   如果这是你第一次连接，系统会提示你 Are you sure you want to continue connecting (yes/no/[fingerprint])?，输入 yes 并回车。 如果看到类似 Hi username! You've successfully authenticated, but GitHub does not provide shell access. 的欢迎信息,说明配置成功！

创建 GitHub 贡献者

如果你还没有 GitHub 账号，请立即访问 github.com 注册一个,它是免费的。

创建并上传你的第一个仓库

这里介绍两种最常见的方法。

在网页端创建，然后克隆到本地 (适合新手)

1. 在 GitHub 创建仓库

   • 登录 GitHub，点击页面右上角的 号，选择 New repository。
   • 填写仓库名称，my-first-project。
   • 可以选择添加描述、设置为公开或私有。
   • 不要 勾选 "Add a README file"（我们先手动创建）。
   • 点击 Create repository。

2. 克隆仓库到本地

   • 在新创建的仓库页面，点击 <> Code 按钮。
   • 在弹出的窗口中，选择 SSH 标签（因为我们配置了 SSH Key）。
   • 复制仓库的 URL，它看起来像 git@github.com:你的用户名/my-first-project.git。
   • 在你的 Mac 上，找一个合适的位置（比如桌面）创建一个文件夹，然后在终端中 cd 到该文件夹下。
   • 运行克隆命令：

     git clone git@github.com:你的用户名/my-first-project.git

   • 一个名为 my-first-project 的文件夹已经出现在你的本地了。

3. 添加文件并提交

   • 进入项目文件夹：

     cd my-first-project

   • 创建一个新文件，README.md：

     echo "# My First Project" >> README.md

   • 查看状态：git status (你会看到一个红色的 README.md，表示它是一个未被 Git 追踪的新文件)
   • 添加文件到暂存区：git add README.md (或者用 git add . 添加所有文件)
   • 提交到本地仓库：git commit -m "feat: add initial README"
     • -m "..." 是提交信息,一定要写清楚你做了什么。
   • 推送到远程 GitHub 仓库：

     git push origin main

     • origin 是默认的远程仓库名称。
     • main 是默认的主分支名称（有些旧仓库可能是 master）。

4. 回到 GitHub 网页，刷新你的仓库页面，你就会看到 README.md 文件已经成功上传了！

在本地创建，然后推送到 GitHub (更常用)

1. 在本地初始化仓库

   • 在你的 Mac 上，创建一个项目文件夹（my-awesome-app），并在终端中 cd 进入该文件夹。
   • 运行以下命令初始化 Git 仓库：

     git init

   • 你会看到 Initialized empty Git repository in ... 的提示。

2. 添加文件并提交

   • 创建一些文件,或者把你的项目文件复制进来。
   • 运行以下命令：

     git add .          # 添加所有文件
     git commit -m "Initial commit" # 提交到本地

3. 在 GitHub 创建仓库

   • 登录 GitHub，点击 -> New repository。
   • 填写仓库名称，my-awesome-app。
   • 勾选 "Add a README file" (这次可以勾，因为我们的本地仓库是空的，或者你已经提交了)。
   • 点击 Create repository。

4. 关联本地仓库并推送

   • GitHub 会给你一个快速设置的指南，找到 …or push an existing repository from the command line 部分。
   • 它会显示两行命令，类似这样：

     git remote add origin git@github.com:你的用户名/my-awesome-app.git
     git branch -M main
     git push -u origin main

   • 直接复制并粘贴 这三行命令到你的终端中执行即可。
   • 第一行：关联你的本地仓库和远程 GitHub 仓库。
   • 第二行：确保你的主分支名为 main。
   • 第三行：将你的本地代码推送到远程，并设置 main 分支为默认上游分支 (-u)。

你的本地项目就已经成功上传到 GitHub 了！

常用 Git 命令详解

日常协作流程：Fork & Pull Request (PR)

这是 GitHub 社区协作的核心。

1. Fork (分叉)

   • 当你想要参与一个你不拥有管理权的开源项目时，首先去该项目的 GitHub 页面。
   • 点击右上角的 Fork 按钮，这会在你的 GitHub 账号下创建这个项目的一个完整副本。

2. Clone (克隆)

   • 去 你自己的 仓库页面 (那个 Fork 过来的版本)。
   • 复制 SSH URL,然后克隆到你的本地电脑。
   • 重要：你还需要添加上游仓库 (原始项目仓库) 的链接，以便获取最新的更新。

     git clone git@github.com:你的用户名/original-project.git
     cd original-project
     git remote add upstream git@github.com:原作者/original-project.git

3. 修改、提交、推送

   • 在本地进行你的修改、添加、提交。
   • 推送到 你自己的 Fork 仓库。

     git push origin your-feature-branch

4. 创建 Pull Request (拉取请求)

   • 回到 GitHub，访问 你自己的 Fork 仓库页面。
   • GitHub 会自动检测到你刚刚的推送，并提示你 "Compare & pull request"。
   • 点击它，填写 PR 的标题和描述,说明你做了哪些修改以及为什么。
   • 点击 Create pull request。

5. 代码审查与合并

   • 原项目的维护者会审查你的代码,可能会提出修改意见。
   • 你可以在你的本地分支上继续修改并推送，PR 会自动更新。
   • 如果审查通过，维护者就会点击 Merge,将你的代码合并到他们的主项目中。

常用 GUI 工具推荐

如果你不喜欢敲命令行，可以使用图形化界面工具,它们能让操作更直观。

• GitHub Desktop: 官方出品，免费，与 GitHub 深度集成,非常适合新手。
• SourceTree: Atlassian 出品，功能强大，免费，支持 Git 和 Mercurial。
• GitKraken: 界面美观，功能强大，有免费版（公开仓库）和付费版（私有仓库）。
• IDE/编辑器内置工具:
  • Visual Studio Code: 安装 GitLens 插件,体验极佳。
  • JetBrains IDEs (如 WebStorm, PyCharm): 内置了非常强大的 Git 工具。

总结与最佳实践

• 先提交，再推送：养成先 git commit 到本地，再 git push 到远程的习惯。
• 写好提交信息：使用清晰的提交信息，feat: 添加新功能、fix: 修复一个 bug、docs: 更新文档,这有助于追踪代码历史。
• 经常拉取：在开始工作前，先 git pull 获取最新的代码,避免和别人产生冲突。
• 理解分支：为每个新功能或 bug 修复创建一个独立的分支，开发完成后再合并到主分支,这是现代软件开发的标准流程。
• 保护你的分支：在 GitHub 仓库的 Settings -> Branches 中，可以设置保护规则，比如禁止直接向主分支推送，必须通过 Pull Request 才能合并,这能极大地保证代码质量。

希望这份详细的教程能帮助你顺利地在 macOS 上开始使用 GitHub！祝你编码愉快！