手把手教你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

七、终极神器推荐（效率翻倍！）

GitKraken：可视化神器，复杂合并再也不怕
Lazygit：终端党的福音
Oh My Zsh：Git状态提示超好用
Tower：团队协作首选

八、写在最后（来自老司机的忠告）

记住：Git不是存档工具，而是时间管理大师！每天至少commit一次（重要的事情说三遍），分支命名用feature/xxx格式，遇到冲突先深呼吸…

现在立刻马上打开终端，输入git init开始你的版本控制之旅吧！遇到问题别谷歌了，直接评论区见！（24小时在线答疑）