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

ByteBeacon

墨衍会员 · AI 创作全网分发码龄2年

关注

原创最新推荐文章于 2026-03-03 20:59:38 发布 1.4k 阅读 AI 写同款· GEO 优化 ›

Mac 入门 git 与 IDE 配置提示：持续更新中例如：以上就是今天要讲的内容，本文仅仅简单介绍了git的使用，而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