首次在mac使用git需完成三步:一、通过homebrew或官网安装git;二、用git config --global配置用户名和邮箱;三、生成ed25519 ssh密钥,添加至ssh-agent并上传公钥到代码平台。

如果您在Mac上首次使用Git进行版本控制,需要完成基础安装、用户身份配置及远程仓库认证设置。以下是实现该目标的完整操作流程:
一、安装Git工具
Git未预装于macOS系统中,需通过包管理器或官方安装包手动安装,确保终端可调用git命令。
1、打开终端应用,输入git --version检查是否已安装;若提示command not found,则尚未安装。
2、若未安装Homebrew,先执行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3、安装完成后运行:brew install git
4、替代方案:访问https://git-scm.com/download/mac下载.pkg安装包,双击运行向导完成安装。
二、配置全局用户名与邮箱
Git提交记录必须关联唯一身份标识,该配置将应用于所有本地仓库,避免后续提交时出现匿名作者或认证失败。
1、执行git config --global user.name "YourName",将YourName替换为您的真实姓名或开发昵称。
2、执行git config --global user.email "youremail@example.com",邮箱须与GitHub/Gitee等平台注册邮箱完全一致。
3、运行git config --list验证两项配置是否已写入全局配置文件。
三、生成SSH密钥对(Ed25519类型)
SSH密钥用于免密码安全连接远程代码托管平台,Ed25519算法提供更高安全性与更短密钥长度,为当前推荐标准。
1、在终端中执行:ssh-keygen -t ed25519 -C "youremail@example.com",邮箱需与上一步git config中设置的邮箱相同。
2、按回车接受默认保存路径~/.ssh/id_ed25519;如路径已存在冲突文件,可输入新路径(如~/.ssh/github_id)。
3、输入并确认一个密码短语(passphrase);该密码用于本地私钥加密,强烈建议设置而非直接回车跳过。
4、执行ls -al ~/.ssh确认生成了id_ed25519(私钥)和id_ed25519.pub(公钥)两个文件。
四、启动SSH代理并添加私钥
ssh-agent负责缓存已解密的私钥,使后续Git操作无需重复输入密码短语,提升操作效率并保障私钥不被明文暴露。
1、运行eval "$(ssh-agent -s)"启动ssh-agent并加载环境变量。
2、针对macOS Monterey及更新系统,执行:ssh-add --apple-use-keychain ~/.ssh/id_ed25519,实现密钥持久化存储至钥匙串。
3、若为macOS Catalina或更早版本,改用:ssh-add -K ~/.ssh/id_ed25519。
五、复制公钥并添加至代码托管平台
公钥需提交至GitHub、Gitee等平台的SSH设置页面,平台据此验证您的推送请求合法性,完成双向信任建立。
1、执行pbcopy 将公钥内容复制到剪贴板。
2、登录GitHub,进入Settings → SSH and GPG keys → New SSH key;标题可填Mac-Ed25519,粘贴公钥内容后点击Add SSH key。
3、登录Gitee,进入设置 → 安全设置 → SSH公钥 → 添加公钥;标题可填Mac-Gitee-Key,粘贴后点击确定。
4、验证连接有效性:执行ssh -T git@github.com或ssh -T git@gitee.com;成功时返回Hi username! You've successfully authenticated。











