Git未找到时,可通过Homebrew、Xcode命令行工具或官方.pkg包安装,并需配置user.name、user.email及SSH密钥以支持提交和免密认证。

如果您在Mac上尝试使用Git命令但终端提示“command not found”,则可能是系统未安装Git或已安装但路径未正确配置。以下是多种可行的安装与配置方法:
一、通过Homebrew安装Git
Homebrew是macOS主流包管理器,能自动处理依赖并提供较新稳定版本的Git,适用于大多数开发者场景。
1、打开“终端”应用,执行brew --version确认Homebrew是否已安装;若无输出,则需先安装。
2、运行官方安装命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)",按提示完成安装。
3、安装完成后执行brew update更新包索引。
4、输入brew install git下载并安装Git。
5、验证安装:执行git --version,若显示类似git version 2.40.1即表示成功。
二、通过Xcode命令行工具安装Git
macOS系统自带Xcode命令行工具中包含一个基础版本的Git,路径为/usr/bin/git,适合对版本一致性要求高且无需最新特性的用户。
1、若尚未安装Xcode,前往App Store下载并安装最新版Xcode。
2、首次启动Xcode后,系统会提示安装额外组件,请全部同意并等待完成。
3、在终端中执行xcode-select --install,弹出窗口中点击“安装”按钮。
4、安装完毕后运行which git,确认返回路径为/usr/bin/git。
5、执行git --version查看当前版本,该方式安装的Git通常为系统兼容版本,可能略旧于Homebrew版本。
三、通过官方.pkg安装包安装Git
该方式直接从Git官方源获取预编译安装包,不依赖第三方包管理器,可确保安装路径全局可用且版本明确。
1、访问Git官网下载页面:https://git-scm.com/download/mac。
2、下载对应macOS架构的最新.pkg文件(Apple Silicon设备下载arm64版本,Intel设备下载x86_64版本)。
3、双击.pkg文件,按向导提示完成安装;安装过程中请勾选“Install for all users”选项。
4、安装完成后,在终端中执行git --version验证是否正常输出版本号。
四、配置Git用户信息
Git要求设置全局用户名和邮箱,用于标识每次提交的作者身份;若未配置或配置错误,提交记录将显示本地主机名而非真实身份。
1、在终端中执行git config --global user.name "Your Name",将Your Name替换为您的真实姓名。
2、执行git config --global user.email "you@example.com",将邮箱替换为与代码托管平台一致的注册邮箱。
3、运行git config --list检查配置是否写入生效;若发现user.name或user.email为空或显示yourname@MacBook-Pro.local,说明配置未成功。
4、如当前目录存在.git/config,其中的[user]段会覆盖全局配置,请检查其内容是否正确或临时删除该段再重试。
五、配置SSH密钥实现免密认证
配置SSH密钥后,可避免每次git push或git clone时重复输入账号密码,并提升与GitHub/GitLab等平台交互的安全性。
1、生成ED25519类型密钥:ssh-keygen -t ed25519 -C "you@example.com",全程按回车使用默认路径。
2、启动SSH代理并加载私钥:eval "$(ssh-agent -s)",随后执行ssh-add ~/.ssh/id_ed25519。
3、复制公钥内容到剪贴板:pbcopy 。
4、登录GitHub或GitLab,在Settings → SSH and GPG keys → New SSH key中粘贴公钥内容并保存。
5、测试连接:ssh -T git@github.com,若返回Hi username! You've successfully authenticated...即表示SSH通道已通。


















