Mac 上从 0 到 1 安装 Git + 配置 GitHub SSH + 拉取 private 仓库的完整步骤

Mac 上从 0 到 1 安装 Git + 配置 GitHub SSH + 拉取 private 仓库的完整步骤，按顺序做就行。Git 官方提供 macOS 安装方式；GitHub 官方提供 SSH 密钥生成、添加到账户、测试连接和 clone 私有仓库的流程。

⸻

一、先确认你要准备什么

你需要有：

• 一台 Mac

• 一个 GitHub 账号，并且已经登录浏览器

• 对方已经把你加入那个 private 仓库

• 你的仓库地址

bash 复制代码

git@github.com:sunyuhuakeyboard/miaohui-project.git

注意：私有仓库必须先有访问权限，才能 clone。只拿到链接但没被加入仓库，是拉不下来的。GitHub 对私有仓库访问是按账号授权控制的。

⸻

二、安装 Git

先打开 Mac 的"终端"。

执行：

bash 复制代码

xcode-select --install

这是 macOS 上常见的 Git 安装方式，Git 官方安装页把 macOS 安装方式列为标准入口之一。

安装完成后，检查是否成功：

bash 复制代码

git --version

正常会看到类似：

bash 复制代码

git version 2.x.x

⸻

三、配置 Git 的用户名和邮箱

这一步建议先做，不然后面提交代码时会缺身份信息。

bash 复制代码

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

检查一下：

bash 复制代码

git config --global --list

你会看到类似：

bash 复制代码

user.name=xxx
user.email=xxx@example.com

⸻

四、检查本机有没有 SSH key

GitHub 官方建议先检查现有 SSH key。

执行：

bash 复制代码

ls -al ~/.ssh

如果你看到类似下面文件，说明以前可能配过：

bash 复制代码

id_ed25519
id_ed25519.pub
id_rsa
id_rsa.pub

如果没有，或者你不想复用旧 key，就新建一个。

⸻

五、生成新的 SSH key

GitHub 官方当前推荐使用 ed25519 类型。

执行：

bash 复制代码

ssh-keygen -t ed25519 -C "你的GitHub邮箱"

比如：

bash 复制代码

ssh-keygen -t ed25519 -C "you@example.com"

执行后会看到提示：

bash 复制代码

Enter file in which to save the key (/Users/你的用户名/.ssh/id_ed25519):

这里直接按回车，使用默认路径就行。

然后会提示你输入密码：

bash 复制代码

Enter passphrase (empty for no passphrase):

这里有两种选择：

• 想更安全：设置一个 passphrase

• 想省事：直接回车留空

接着再确认一次。

生成成功后，默认会得到这两个文件：

• 私钥：~/.ssh/id_ed25519

• 公钥：~/.ssh/id_ed25519.pub

⸻

六、把 SSH key 加到 ssh-agent

GitHub 官方文档建议把 key 加入 ssh-agent，这样后面不需要反复输入。

先启动 agent：

bash 复制代码

eval "$(ssh-agent -s)"

然后添加 key：

bash 复制代码

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

如果你的系统不支持这个参数，可以用：

bash 复制代码

ssh-add ~/.ssh/id_ed25519

⸻

七、复制公钥内容

把公钥打印出来：

bash 复制代码

cat ~/.ssh/id_ed25519.pub

你会看到一整行，类似这样：

bash 复制代码

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI...... your@email.com

把这一整行完整复制。

不要复制私钥文件 id_ed25519，只能复制 .pub 公钥。

⸻

八、把公钥添加到 GitHub 账号

GitHub 官方要求把公钥添加到账户里，才能通过 SSH 访问仓库。

在浏览器打开 GitHub，然后进入：

bash 复制代码

头像 → Settings → SSH and GPG keys → New SSH key

然后：

• Title：写个容易识别的名字，例如 MacBook-Air 或 Work-Mac

• Key type：默认 Authentication Key

• Key：把刚才复制的整行公钥粘贴进去

保存。

⸻

九、测试 SSH 是否连通 GitHub

GitHub 官方有专门的测试命令。

执行：

bash 复制代码

ssh -T git@github.com

第一次会看到类似：

bash 复制代码

The authenticity of host 'github.com (...)' can't be established.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

输入：

bash 复制代码

yes

如果配置成功，你会看到类似欢迎信息：

bash 复制代码

Hi your-github-username! You've successfully authenticated, but GitHub does not provide shell access.

这就表示 SSH 配好了。

⸻

十、确认你已经有 private 仓库权限

你的仓库是：

bash 复制代码

https://github.com/sunyuhuakeyboard/miaohui-project.git

对应 SSH 地址是：

bash 复制代码

git@github.com:sunyuhuakeyboard/miaohui-project.git

在 clone 之前要确认两件事：

你登录的是被邀请的那个 GitHub 账号
这个账号已经被加到 private 仓库里，并且已接受邀请

如果没权限，clone 会报：

bash 复制代码

Repository not found.

或者：

bash 复制代码

Permission denied (publickey).

⸻

十一、把 private 仓库拉到本地

先进入你想存放代码的目录，比如桌面：

bash 复制代码

cd ~/Desktop

然后执行 clone：

bash 复制代码

git clone git@github.com:sunyuhuakeyboard/miaohui-project.git

GitHub 官方说明，仓库可以通过 SSH URL clone。

拉取成功后进入项目目录：

bash 复制代码

cd miaohui-project

查看远程地址：

bash 复制代码

git remote -v

正常会看到：

bash 复制代码

origin  git@github.com:sunyuhuakeyboard/miaohui-project.git (fetch)
origin  git@github.com:sunyuhuakeyboard/miaohui-project.git (push)

⸻

十二、开始参与开发的基本流程

一般不要直接在主分支上乱改，建议建自己的分支。

先看当前分支：

bash 复制代码

git branch

拉一下最新代码：

bash 复制代码

git pull origin main

如果默认分支不是 main，可能是 master，先执行：

bash 复制代码

git branch -r

看远程分支名称。

创建并切换到自己的开发分支：

bash 复制代码

git checkout -b feat/your-name-init

改完代码后：

bash 复制代码

git add .
git commit -m "feat: 初始化本地开发修改"
git push -u origin feat/your-name-init

然后到 GitHub 页面发起 Pull Request。

⸻

十三、你可以直接发给同事的极简版步骤

如果你是要发给别人，可以直接把下面这段给他：

1. 安装 Git

bash 复制代码

xcode-select --install

2. 配置 Git

bash 复制代码

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

3. 生成 SSH key

bash 复制代码

ssh-keygen -t ed25519 -C "你的GitHub邮箱"

4. 启动 ssh-agent

bash 复制代码

eval "$(ssh-agent -s)"

5. 添加 SSH key

bash 复制代码

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

6. 复制公钥

bash 复制代码

cat ~/.ssh/id_ed25519.pub

7. 到 GitHub -> Settings -> SSH and GPG keys 添加公钥

8. 测试 SSH

bash 复制代码

ssh -T git@github.com

9. 拉取 private 仓库

bash 复制代码

git clone git@github.com:sunyuhuakeyboard/miaohui-project.git

⸻

十四、最常见报错和解决办法

bash 复制代码

1）git: command not found

说明 Git 没装好。重新执行：

bash 复制代码

xcode-select --install

2）Permission denied (publickey)

说明 SSH 没配好。通常检查这几个点：

• 公钥没加到 GitHub

• 加错 GitHub 账号

• 本地没加到 ssh-agent

• 用的不是对应私钥

可以重新测试：

bash 复制代码

ssh -T git@github.com

3）Repository not found

通常不是地址错，而是：

• 仓库是 private

• 你的 GitHub 账号没权限

• 还没接受邀请

4）一直要求输入密码

通常是没有用 SSH 地址，而是用了 HTTPS 地址。

你要确认远程地址是：

bash 复制代码

git@github.com:sunyuhuakeyboard/miaohui-project.git

不是：

https://github.com/...

⸻

十五、推荐你们小团队的做法

对于 private 仓库协作，最稳的是：

• 每个人都配置 SSH

• 每个人都用自己的 GitHub 账号

• 仓库管理员把成员加到仓库

• 不直接改主分支

• 用分支 + PR 合并

这样后面多人协作会顺很多。

Mac 上从 0 到 1 安装 Git + 配置 GitHub SSH + 拉取 private 仓库 的完整步骤

1. 安装 Git

2. 配置 Git

3. 生成 SSH key

4. 启动 ssh-agent

5. 添加 SSH key

6. 复制公钥

7. 到 GitHub -> Settings -> SSH and GPG keys 添加公钥

8. 测试 SSH

9. 拉取 private 仓库

Mac 上从 0 到 1 安装 Git + 配置 GitHub SSH + 拉取 private 仓库的完整步骤