前置条件
- 一台运行 macOS 的电脑
- 已安装 Xcode Command Line Tools(Git 和编译工具依赖)
在 macOS 系统上配置和使用 Git 拉取项目的完整流程。内容包括安装 Git(通过 Homebrew 或 Xcode)、配置用户信息、生成并添加 SSH Key 到 GitHub/GitLab、克隆仓库以及常见问题排查。重点推荐 SSH 方式连接以避免频繁输入密码,并提供了权限拒绝等常见错误的解决方案。适合需要在 Mac 环境下进行版本控制开发的开发者参考。

brew install git
安装完成后,输入以下命令检查是否安装成功:
git --version
输出示例:
git version 2.42.0
xcode-select --install
安装完成后即可使用 Git。
首次使用 Git,需配置用户名和邮箱:
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱@example.com"
查看当前的 Git 配置信息:
git config --global --list
为了避免频繁输入用户名和密码,建议使用 SSH 方式连接仓库。
ssh-keygen -t ed25519 -C "你的邮箱@example.com"
按提示一路回车,默认会生成以下两个文件:
~/.ssh/id_ed25519~/.ssh/id_ed25519.pubeval "$(ssh-agent -s)" ssh-add --apple-use-keychain ~/.ssh/id_ed25519
pbcopy < ~/.ssh/id_ed25519.pub
点击 "New SSH Key",粘贴内容,填写标题,保存即可。
git clone [email protected]:用户名/仓库名.git
示例:
git clone [email protected]:octocat/Hello-World.git
git clone https://github.com/用户名/仓库名.git
这种方式在每次推送或拉取时通常会要求输入用户名和密码(或者令牌),不够方便。
错误提示:
zsh: command not found: git
解决方法:确认是否已正确安装 Git,可以使用 brew install git 重新安装。
可能原因及解决方案:
[email protected]:xxx/xxx.giteval "$(ssh-agent -s)" ssh-add --apple-use-keychain ~/.ssh/id_ed25519

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online