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安装与配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
使用TeXLive2022和VSCode安装配置步骤(LaTeX写论文)
这篇文章主要介绍了使用TeXLive2022和VSCode的安装配置步骤，本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下2022-07-07
这篇文章主要介绍了关于Typora中latex的用法与常用语法,typora使用latex进行公式的编写,本文说明了常用的语法,需要的朋友可以参考下2023-04-04
文章介绍了如何通过命令行使用Git回滚到特定版本的详细步骤,包括查看提交记录、定位到特定的commit ID、使用git reset回滚本地文件,并最终强制提交到远程分支2025-12-12
这篇文章主要介绍了Visual Studio安装git插件的方法步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2021-04-04
这篇文章主要给大家介绍了关于vscode中setting.json配置文件配置的相关资料,VSCode中的setting.json文件用于存储用户自定义的配置设置,文中给出了详细的代码示例,需要的朋友可以参考下2023-09-09
这篇文章主要介绍了gitlab项目实现添加新成员方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教2025-11-11
vscode检测到#include错误请更新includePath的解决方法
这篇文章主要介绍了vscode检测到#include错误请更新includePath的解决方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-08-08
下面小编就为大家分享一篇完美解决webstorm启动索引文件卡死的问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2017-11-11
今天跟大家聊聊最后三种排序： 直接插入排序，希尔排序和归并排序2013-11-11
Wireshark是一个网络数据包分析软件,功能非常强大，奈何他是英文版的，今天就为大家详细介绍一下网络抓包工具wireshark的使用教程2018-10-10
最新评论