MacOS系统下Git的详细安装步骤与基础设置指南
更新时间：2026年04月14日 09:42:39 作者：独隅
本文介绍了在MacOS上安装Git的的不同方法,包括通过Homebrew安装、通过XcodeCommandLineTools安装和手动下载安装包安装,此外,还还介绍了配置用户名和邮箱、配置SSH密钥、配置差异工具和Git代理等以及解决安装过程中可能出现的常见问题,需要的朋友可以参考下
一、安装 Git
方法 1：通过 Homebrew 安装（推荐）
安装 Homebrew（若未安装）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 安装完成后，重启终端。
通过 Homebrew 安装 Git：
brew install git
验证安装：
git --version
• 输出类似 git version 2.39.0 表示成功。
方法 2：通过 Xcode Command Line Tools 安装
安装 Xcode Command Line Tools：
xcode-select --install
系统会弹出图形化安装界面，按提示完成安装。
验证 Git 是否自带安装：
git --version
MacOS 默认会安装 Git，但版本可能较旧（如 2.37.0）。
方法 3：手动下载安装包
- 访问 Git 官网下载页面：
https://git-scm.com/download/mac - 下载
.dmg文件（如git-2.39.0-intel-universal-mavericks.dmg）。 - 挂载并安装：
• 双击下载的.dmg文件，将 Git.app 拖入 Applications 文件夹。 - 配置环境变量：
# 将 Git 添加到 PATH（若手动安装未自动配置） echo 'export PATH="/Applications/Git.app/Contents/Resources/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
二、基础配置
1. 设置全局用户名和邮箱
git config --global user.name "Your Name" git config --global user.email "your.email@example.com"
• 验证配置：
git config --global --list
2. 配置 SSH 密钥（用于 GitHub/GitLab 等）
生成 SSH 密钥：
ssh-keygen -t ed25519 -C "your.email@example.com"
• 按提示保存密钥到默认路径（~/.ssh/id_ed25519）。
• 设置密钥密码（可选）。
将公钥添加到 GitHub/GitLab：
• 复制公钥内容：
cat ~/.ssh/id_ed25519.pub
• 登录 GitHub → Settings → SSH and GPG Keys → 添加新 SSH Key。
测试 SSH 连接：
ssh -T git@github.com
• 成功提示：Hi username! You've successfully authenticated.
3. 配置 Git 别名（简化命令）
git config --global alias.co checkout git config --global alias.br branch git config --global alias.st status git config --global alias.lg "log --oneline --graph --all"
• 示例：git st 等同于 git status。
4. 启用 Git 自动换行符转换
git config --global core.autocrlf input # MacOS/Linux git config --global core.safecrlf warn # 检测混合换行符
三、高级设置
1. 配置差异工具（如 Beyond Compare）
- 安装 Beyond Compare（需购买或下载试用版）。
- 配置 Git 调用 Beyond Compare：
git config --global merge.tool bc3 git config --global mergetool.bc3.path "/Applications/Beyond Compare.app/Contents/MacOS/bcomp"
2. 配置 Git 代理（解决网络问题）
# HTTP/HTTPS 代理 git config --global http.proxy http://127.0.0.1:7890 git config --global https.proxy https://127.0.0.1:7890 # SOCKS5 代理（如 Clash） git config --global http.proxy socks5://127.0.0.1:7890 git config --global https.proxy socks5://127.0.0.1:7890 # 取消代理 git config --global --unset http.proxy git config --global --unset https.proxy
四、常见问题与解决方法
1. 安装失败：Error: The following directories are not writable by your user
• 解决：使用 sudo 或修复目录权限：
sudo chown -R $(whoami) /usr/local/*
2. 权限错误：Permission denied (publickey)
• 解决：
确认 SSH 密钥已添加到 ssh-agent：
eval "$(ssh-agent -s)" ssh-add ~/.ssh/id_ed25519
检查公钥是否正确添加到 GitHub/GitLab。
3. Git 版本过旧
• 升级 Git：
brew update && brew upgrade git
4. 终端提示git: command not found
• 解决：
• 检查是否已安装 Git：which git。
• 若未安装，通过上述方法重新安装。
• 确保 Git 路径在环境变量中（echo $PATH）。
五、卸载 Git
# 通过 Homebrew 卸载 brew uninstall git # 手动删除（若通过 dmg 安装） sudo rm -rf /Applications/Git.app sudo rm -rf /usr/local/git
到此这篇关于MacOS系统下Git的详细安装步骤与基础设置指南的文章就介绍到这了,更多相关MacOS Git安装与配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
这篇文章主要为大家介绍了整理超全的visual studio快捷键使用技巧，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-02-02
这里来说说get与post的区别与联系，对这方面不懂的鹏哟可以参考下。2011-04-04
这篇文章主要介绍了手把手教你将Vim改装成一个IDE编程环境(图文) 吴垠 ,需要的朋友可以参考下2016-01-01
本篇文章主要介绍了Git标签管理的相关知识。具有很好的参考价值。下面跟着小编一起来看下吧2017-04-04
这篇文章主要介绍了Windows 版本Git命令行的使用详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-07-07
本文总结Git操作流程,初始化本地仓库并添加文件,关联远程仓库后克隆代码；初次使用仅需克隆,上传代码需切换目标分支并推送,若克隆失败需配置SSH公钥,适用于代码版本管理基础操作2025-07-07
使用层制作的下拉菜单下正好有FLASH动画,菜单被动画遮挡.2009-08-08
这两年因为第三波人工智能热潮让 Python火了一把，让中小学生、非程序员(产品经理、运营)都加入到了学习Python的行列，那之前Python火吗2019-06-06
Git.gitignore仅对未跟踪文件生效,已提交文件需手动移除,需检查文件位置、语法及缓存,不同项目配置示例,建议尽早设置并使用全局.gitignore2025-09-09
本文详细介绍了如何使用Git拉取项目分支代码,并提供了解决常见问题（如fatal: unable to update url base from redirection）的步骤,问题解决的关键在于确保你有项目的访问权限2026-01-01
最新评论