1. 安装git之前,先搞清楚你装的到底是什么
很多人把"装个git"理解成"下载一个安装包双击下一步",装完在命令行敲一句git --version能蹦出版本号,就以为大功告成。实际用上两天,各种莫名其妙的问题就全来了:提交上去的代码换行符乱掉、git pull要反复输密码、不同仓库的身份搞混、中文文件名显示成一串数字……这时候回头排查,根子全都在安装配置那一步埋下了。
所以这篇文章我不想只写"下载、点下一步、完成",而是把git安装和配置这一整套东西拆开讲清楚。你会明白每个配置项到底是干嘛的、为什么这么设、哪些坑是我实际踩过之后才长记性的。内容同时覆盖Windows、macOS和Linux三种环境,无论你是刚接触版本控制的新手,还是换新电脑需要重新配环境的老手,照着做基本都能一次跑通。
先说一个基础认知。git本身是一个命令行工具,它跟GitHub、GitLab、Gitee这些平台是两码事。git是跑在你本地的一个版本管理程序,那些平台只是帮你托管远程仓库的服务商。这个关系理不清,后面配置的时候特别容易犯迷糊——很多人以为装了git就等于注册了GitHub账号,其实完全不是一回事。
另外还需要理解一个概念:git安装完之后,它本身几乎是"不可用"的。你没看错,刚装完的git连git commit都执行不了,因为git不知道你是谁。版本管理最核心的一件事,就是记录"谁在什么时间改了什么",所以身份信息是git的硬性要求,不是可选项。这就是为什么很多教程会反反复复强调配置user.name和user.email。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 各平台的安装过程与最容易出错的细节
2.1 Windows:别默认下一步,这两个勾选项影响很大
Windows下安装git,绝大多数人用的是官方出的Git for Windows,下载地址是git-scm.com,进去之后点Downloads会自动识别系统版本。安装向导一路点Next确实能装完,但有几个界面我建议你停一下,把选项改掉再继续。
第一个是"Select Components"这个页面,里面有个Git Bash Here和Git GUI Here的右键菜单选项,默认是勾上的。建议保留,后面用起来非常方便。真正需要动的是"Default editor"这个选择——默认是Vim。如果你不熟悉Vim的操作方式(进入编辑模式要按i,退出保存要按Esc然后输:wq),建议直接选成Notepad++或者VS Code,否则以后每次git commit打开编辑器,你都会卡在"怎么保存退出"这一步。
第二个关键的页面叫"Adjusting your PATH environment",里面有三个单选选项。一定要选中间那个**"Git from the command line and also from 3rd-party software"**,这样git命令才能在任何终端窗口里直接用。如果你选了默认的"Use Git Bash only",打开Windows自带的CMD或者PowerShell敲git会提示找不到命令。第三个选项"Use Git and optional Unix tools from the Command Prompt"不建议选,它会把一堆Unix工具混进Windows的环境变量里,容易跟系统自带的命令产生冲突。
安装包默认装到C:\Program Files\Git,这个路径保持默认就行,不用改。装完之后打开任意终端,敲git --version,如果能看到版本号,说明安装成功。
2.2 macOS:先搞清楚你用的是Apple Silicon还是Intel芯片
macOS装git有个特殊情况:系统里可能已经预装了一个版本。苹果的Xcode Command Line Tools会自带一个git,但那个版本通常比较旧,而且某些功能被裁剪过。所以正规做法是自己装一个干净版本。
ARM芯片(M1/M2/M3系列)的Mac,建议优先用Homebrew安装,命令是brew install git。Intel芯片的Mac也可以用这个方式。装之前先确认Homebrew本身是好的,brew --version能输出版本号再继续。
还有一种方式是用官方安装包,从git-scm.com下载macOS版本的dmg文件直接安装。这种方式的好处是跟系统环境隔离得比较干净,装完在/usr/local/git/bin或者/opt/homebrew/bin下面能找到可执行文件。需要注意一个细节:macOS的SIP(System Integrity Protection)机制可能会拦截未签名的二进制文件,如果你下载的安装包提示"无法打开,因为无法验证开发者",需要去系统设置里的"隐私与安全性"手动允许。官网的安装包是签了名的,一般不会触发这个提示,但你从网上随便下载的第三方构建版本就不好说了。
装完验证一下当前用的是哪个git:which git。如果你发现指向的是/usr/bin/git而不是Homebrew的路径,说明PATH环境变量里系统目录排在了前面。这时候要么改PATH顺序,要么干脆接受系统版本——但我建议还是改成自己装的版本,后面配置一些扩展工具时会省心很多。
2.3 Linux:包管理器安装最省事,但版本可能偏旧
Debian/Ubuntu系用sudo apt install git,CentOS/RHEL系用sudo yum install git或者sudo dnf install git,Arch系用sudo pacman -S git。这是最简单的安装方式,但有个隐患:很多发行版的软件源里git版本比较旧,默认分支名还是master而不是main,某
