手把手教你MacOS安装配置Git开发环境（附避坑指南）

MacOS安装配置Git开发环境全攻略

最新推荐文章于 2025-11-01 20:52:15 发布

原创最新推荐文章于 2025-11-01 20:52:15 发布 · 1.2k 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#macos #git #其他

文章目录

一、为什么每个开发者都要装Git？（这不是选择题！）

各位代码战士注意了！！！在2024年还不会用Git的程序员，就像不会用筷子的中餐厨师一样离谱（别打我，实话实说）。无论你是刚入行的萌新还是十年老兵，Git都是你代码生涯的防弹衣+时光机！

二、两种安装方式任君选择（总有一款适合你）

方案A：Homebrew一键流（推荐指数★★★★★）

打开终端输入这个魔法咒语：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

等进度条跑完（可以去冲杯咖啡☕），接着输入：

brew install git

看到绿色的🍺 Successfully installed git就稳了！用git --version检查版本号，建议保持v2.40+版本（低版本可能会遇到灵异事件）

方案B：官网下载安装包（适合网络困难户）

访问Git官网（注意认准官方域名！！！）
下载最新版.pkg安装包（当前最新是2.44.0）
双击安装时可能会弹出安全警告（别慌！按住Control键再点打开）
一直点"继续"直到安装完成（中间有个自定义路径选项，小白别乱改！）

三、必须做的初始配置（不做后果自负！）

在终端依次执行：

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的注册邮箱"
git config --global core.editor "nano"  # 推荐vscode用户改成"code --wait"

（超级重要）这三条命令相当于给你的代码打上身份证！忘记配置的话，你提交的代码会显示unknown user，团队协作时等着被同事追杀吧…

四、SSH密钥配置（GitHub/GitLab通行证）

生成密钥对：

ssh-keygen -t ed25519 -C "你的邮箱"

（全程回车就行，密码可设可不设）

查看公钥：

cat ~/.ssh/id_ed25519.pub

把显示的内容完整复制到GitHub的SSH Keys设置页

验证连接：

ssh -T git@github.com

看到You've successfully authenticated就是成功了！（失败的话检查代理设置）

五、新手必踩的五大深坑（附逃生指南）

坑1：xcode-select报错

报错信息：

xcode-select: error: command line tools are already installed

解法：执行sudo xcode-select --reset后重试

坑2：权限拒绝(permission denied)

典型症状：

fatal: could not create work tree dir '...': Permission denied

解法：用sudo chmod -R 755 /目标目录开放权限（慎用sudo！）

坑3：中文乱码

在终端输入：

git config --global core.quotepath false
git config --global gui.encoding utf-8

坑4：GitHub连接超时

修改Hosts文件：

140.82.113.3 github.com
185.199.108.153 assets-cdn.github.com

坑5：提交历史被污染

误操作后急救命令：

git reflog  # 查看操作记录
git reset --hard HEAD@{数字}  # 穿越回某个节点

六、高阶玩家配置（让你的Git飞起来）

.gitconfig文件追加：

[alias]
    st = status
    ci = commit
    br = branch
    co = checkout
    df = diff
    lol = log --graph --decorate --oneline --abbrev-commit
    lola = log --graph --decorate --oneline --abbrev-commit --all
[color]
    ui = auto
[push]
    default = current