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

StackOverthink

于 2025-05-03 19:04:58 发布

阅读量347

点赞数 4

文章标签： macos git

本文链接：https://blog.youkuaiyun.com/StackOverthink/article/details/147686235

版权

一、为什么每个程序员都需要Git？（新手必看）

刚接触编程那会儿，我最怕听到同事说"你这个commit有问题啊"（别笑！）。直到学会Git，才明白版本控制简直是程序员的后悔药💊！MacOS作为开发者的主力系统，自带Git但版本老旧（2023年了还默认用2.30.1你敢信？），今天教大家从安装到配置的完整攻略，文末还有我踩过的5个坑，建议收藏备用！

二、两种安装方式任你选

方案A：用Homebrew安装（推荐指数⭐⭐⭐⭐⭐）

打开终端输入：

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

等进度条走完（可以去泡杯咖啡☕）后：

brew install git

验证安装：

git --version
# 应该显示最新版如2.41.0

方案B：官网直装（适合洁癖患者）

访问Git官网（注意！别下到windows版）
下载最新.pkg文件
双击安装（需要输入密码💻）

👉实测对比：Homebrew方式后续更新更方便，但官网安装更干净

三、必须做的5个基础配置（漏一个后悔！）

1. 设置身份标识（重要！！！）

git config --global user.name "你的名字"
git config --global user.email "公司邮箱"
# 注意！这里要填公司邮箱不是私人邮箱（血泪教训）

2. 修改默认编辑器（告别vim地狱）

git config --global core.editor "code --wait"
# 需要先装VS Code，其他编辑器替换code即可

3. 生成SSH密钥（连接GitHub必备）

ssh-keygen -t ed25519 -C "你的邮箱"
# 连续回车三次（别设密码！本地开发不需要）
cat ~/.ssh/id_ed25519.pub
# 复制输出的内容到GitHub的SSH Keys

4. 配置.gitignore（拒绝垃圾文件）

创建~/.gitignore_global文件：

.DS_Store
node_modules/
*.log
.idea/

然后执行：

git config --global core.excludesfile ~/.gitignore_global

5. 开启颜色显示（终端更友好）

git config --global color.ui auto

四、新手必遇的5大坑（附解决方案）

坑1：Permission denied (publickey)

🔥症状：push代码时提示权限错误
✅解决：

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

坑2：中文文件名乱码

🔥症状：git status显示\346\226…
✅解决：

git config --global core.quotepath false

坑3：换行符冲突

🔥症状：Windows同事提交的文件全是^M
✅解决：

git config --global core.autocrlf input

坑4：提交大文件失败

🔥症状：remote: error: File is 135.34 MB…
✅解决：

brew install git-lfs
git lfs install
git lfs track "*.psd"

坑5：Git突然变慢

🔥症状：git clone卡在20%
✅检查：

git config --global http.proxy  # 看看是不是开了代理
ping github.com                 # 测试网络连通性

五、进阶技巧（老鸟也未必知道）

1. 命令别名设置

在~/.gitconfig添加：

[alias]
    st = status
    ci = commit
    br = branch
    co = checkout

2. 自动补全

brew install bash-completion
echo 'source /usr/local/etc/bash_completion.d/git-completion.bash' >> ~/.bash_profile

3. 图形化工具

推荐使用Fork（比官方客户端快10倍！）

六、写在最后

记得第一次用git merge时把同事代码全删了（冷汗.jpg），现在想想都是配置没做好。按照本文配置后，你的Git环境已经超过80%的开发者了（真实数据！）。如果遇到其他问题，欢迎评论区留言——看到必回！下期预告：《Git分支管理实战：从青铜到王者》，关注不迷路~