GitHub for Mac 新手入门完整教程
目录
- 准备工作
- 安装 Xcode Command Line Tools (包含 Git)
- 注册 GitHub 账号
- Git 基础配置
- 配置用户名和邮箱
- 配置 SSH 密钥（推荐，免去每次输入密码的麻烦）
- 核心操作：本地仓库与远程仓库的联动
- 从零开始创建新项目
- 第1步：在本地创建项目文件夹
- 第2步：初始化 Git 仓库 (
git init) - 第3步：添加文件到暂存区 (
git add) - 第4步：提交更改 (
git commit) - 第5步：在 GitHub 上创建远程仓库
- 第6步：将本地仓库与远程仓库关联 (
git remote) - 第7步：推送代码到 GitHub (
git push)
- 参与一个已有的项目
- 第1步：从 GitHub 克隆项目到本地 (
git clone) - 第2步：修改代码
- 第3步：提交并推送更改 (
git commit&git push)
- 第1步：从 GitHub 克隆项目到本地 (
- 从零开始创建新项目
- 进阶与协作
- 分支简介 (
git branch,git checkout) - 创建 Pull Request (PR)
- 解决合并冲突
- 分支简介 (
- 常用 Git 命令速查表
- 推荐工具
准备工作
1 安装 Xcode Command Line Tools (包含 Git)
macOS 系统本身不自带 Git，但苹果在 Xcode 开发工具中集成了 Git，这是在 Mac 上安装 Git 最简单、最官方的方式。
- 打开 “终端” 应用，你可以在
应用程序->实用工具文件夹里找到它，或者使用 Spotlight 搜索（按Command + 空格键）输入终端并回车。 - 在终端中输入以下命令并按回车：
xcode-select --install
- 系统会弹出一个安装器窗口,点击 “安装” 并同意条款。
- 安装完成后,验证 Git 是否已成功安装，在终端中输入：
git --version
如果看到类似
git version 2.x.x的输出，说明 Git 已经安装好了。
2 注册 GitHub 账号
如果你还没有 GitHub 账号，请访问 github.com 点击右上角的 "Sign up" 按钮完成注册，整个过程是免费的。
Git 基础配置
配置你的身份信息,这些信息会记录在你每一次的代码提交中。
1 配置用户名和邮箱
打开终端,分别运行以下两条命令，请将 Your Name 和 your_email@example.com 替换成你自己的信息。
# 设置你的用户名，这会显示在 GitHub 上 git config --global user.name "Your Name" # 设置你的邮箱，必须与你的 GitHub 账号邮箱一致 git config --global user.email "your_email@example.com"
你可以用以下命令查看所有全局配置：
git config --list
2 配置 SSH 密钥（强烈推荐）
使用 SSH（Secure Shell）可以让你在推送和拉取代码时，无需每次都输入 GitHub 的用户名和密码，它会用密钥对进行安全验证。
-
检查是否已有 SSH 密钥 在终端中输入：
ls -al ~/.ssh
如果看到
id_rsa.pub或id_ecdsa.pub或id_ed25519.pub文件，说明你已经有一个密钥了，可以跳到第 4 步。
（图片来源网络，侵删） -
生成新的 SSH 密钥 如果没有密钥文件，或者你想创建一个新的，请运行以下命令，将
your_email@example.com替换成你的 GitHub 邮箱。ssh-keygen -t ed25519 -C "your_email@example.com"
-t ed25519指定了密钥的类型，这是目前推荐使用的、更安全的类型。- 系统会提示你保存密钥的位置,直接按回车键使用默认路径 (
~/.ssh/id_ed25519)。 - 接着会要求你输入一个密码（Passphrase），这是一个额外的安全层，可以防止别人盗用你的私钥。建议设置一个密码，每次使用 SSH 密钥时都需要输入。
-
启动 SSH 代理 SSH 代理可以帮助你管理密钥，运行以下命令：
# 如果你使用的是 macOS Catalina (10.15) 或更高版本 eval "$(ssh-agent -s)" # 如果你使用的是 macOS Mojave (10.14) 或更早版本 eval "$(ssh-agent -s)"
然后将私钥添加到 SSH 代理中：
ssh-add ~/.ssh/id_ed25519
如果你在第 2 步设置了密码，这时需要输入它。
-
将公钥添加到 GitHub
- 复制你的公钥内容,公钥文件是
id_ed25519.pub，在终端中运行：pbcopy < ~/.ssh/id_ed25519.pub
这个命令会将公钥内容直接复制到你的剪贴板。
pbcopy命令不可用，你可以用cat ~/.ssh/id_ed25519.pub命令查看并手动复制。 - 登录你的 GitHub 账号。
- 点击右上角的头像,选择 Settings。
- 在左侧菜单栏,点击 SSH and GPG keys。
- 点击 New SSH key 按钮。
- 给你的密钥起一个名字（"MacBook Pro"），然后将剪贴板中的公钥内容粘贴到 "Key" 文本框中。
- 点击 "Add SSH key"。
- 复制你的公钥内容,公钥文件是
-
测试连接 在终端中运行：
ssh -T git@github.com
首次连接时,系统会询问你是否继续连接（Are you sure you want to continue connecting?），输入
yes并回车。 如果看到类似Hi username! You've successfully authenticated...的欢迎信息，说明你的 SSH 密钥配置成功了！
核心操作：本地仓库与远程仓库的联动
这是最常用的两种工作流程。
从零开始创建新项目
假设你要创建一个名为 my-awesome-project 的项目。
-
第1步：在本地创建项目文件夹
# 创建一个新文件夹 mkdir my-awesome-project # 进入这个文件夹 cd my-awesome-project # 初始化一个 Git 仓库 git init
git init会在你的文件夹里创建一个隐藏的.git目录，用于跟踪所有版本历史。 -
第2步：添加文件到暂存区 假设你已经创建了一个
README.md文件，现在需要告诉 Git 你要管理这个文件。# 添加所有文件到暂存区 git add . # 或者只添加特定文件 # git add README.md
git add .中的 代表当前目录下的所有文件。 -
第3步：提交更改 将暂存区的文件永久保存到本地仓库。
git commit -m "feat: initial commit with README"
-m后面跟的是提交信息，写清楚这次提交做了什么，这是一个好习惯。 -
第4步：在 GitHub 上创建远程仓库
- 登录 GitHub，点击页面右上角的 号，选择 New repository。
- 给你的仓库起一个名字,
my-awesome-project（最好和本地文件夹名保持一致）。 - 可以选择公开或私有。
- 不要 勾选 "Add a README file"（因为我们已经本地有了）。
- 点击 Create repository。
-
第5步：将本地仓库与远程仓库关联 GitHub 会给你一个仓库地址，复制它（选择 SSH 格式）。
# 在你的项目文件夹中（终端还在 my-awesome-project 目录下） # 将下面的 URL 替换成你自己的仓库 URL git remote add origin git@github.com:你的
