MacOS系统下Git的详细安装步骤与基础设置指南

目录

• 一、安装 Git
• 方法 1：通过 Homebrew 安装（推荐）
• 方法 2：通过 Xcode Command Line Tools 安装
• 方法 3：手动下载安装包
• 二、基础配置
• 1. 设置全局用户名和邮箱
• 2. 配置 SSH 密钥（用于 GitHub/GitLab 等）
• 3. 配置 Git 别名（简化命令）
• 4. 启用 Git 自动换行符转换
• 三、高级设置
• 1. 配置差异工具（如 Beyond Compare）
• 2. 配置 Git 代理（解决网络问题）
• 四、常见问题与解决方法
• 1. 安装失败：Error: The following directories are not writable by your user
• 2. 权限错误：Permission denied (publickey)
• 3. Git 版本过旧
• 4. 终端提示git: command not found
• 五、卸载 Git

安装 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 表示成功。

安装 Xcode Command Line Tools：

xcode-select --install

系统会弹出图形化安装界面，按提示完成安装。

验证 Git 是否自带安装：

git --version

MacOS 默认会安装 Git，但版本可能较旧（如 2.37.0）。

1. 访问 Git 官网下载页面：
   https://git-scm.com/download/mac
2. 下载 .dmg 文件（如 git-2.39.0-intel-universal-mavericks.dmg）。
3. 挂载并安装：
   • 双击下载的 .dmg 文件，将 Git.app 拖入 Applications 文件夹。
4. 配置环境变量：

# 将 Git 添加到 PATH（若手动安装未自动配置）
echo 'export PATH="/Applications/Git.app/Contents/Resources/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

• 验证配置：

git config --global --list

生成 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.

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。

git config --global core.autocrlf input  # MacOS/Linux
git config --global core.safecrlf warn    # 检测混合换行符

1. 安装 Beyond Compare（需购买或下载试用版）。
2. 配置 Git 调用 Beyond Compare：

git config --global merge.tool bc3
git config --global mergetool.bc3.path "/Applications/Beyond Compare.app/Contents/MacOS/bcomp"

# 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

• 解决：使用 sudo 或修复目录权限：

sudo chown -R $(whoami) /usr/local/*

• 解决：

确认 SSH 密钥已添加到 ssh-agent：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

检查公钥是否正确添加到 GitHub/GitLab。

• 升级 Git：

brew update && brew upgrade git

• 解决：
• 检查是否已安装 Git：which git。
• 若未安装，通过上述方法重新安装。
• 确保 Git 路径在环境变量中（echo $PATH）。

# 通过 Homebrew 卸载
brew uninstall git

# 手动删除（若通过 dmg 安装）
sudo rm -rf /Applications/Git.app
sudo rm -rf /usr/local/git

到此这篇关于MacOS系统下Git的详细安装步骤与基础设置指南的文章就介绍到这了,更多相关MacOS Git安装与配置内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客！

您可能感兴趣的文章:

• Docker GitLab的安装完整配置项说明教程
• gitlab安装及邮箱配置和常用使用方式
• docker安装Jenkins配置Gitee SSH密钥踩坑解决
• TortoiseGit的安装与配置教程
• Git下载、安装与环境配置的详细教程