Git下载安装与基础配置详解，避开新手常见坑

很多刚接触代码的朋友第一次打开Git官网的时候其实是懵的——页面上全是英文下载链接一多不知道该点哪一个好不容易下载了安装包双击之后一路Next装完跑到命令行敲了个git --version却提示“不是内部或外部命令”。这个场景我见过太多次了不管是带新人还是给同事配环境十个人里有五个会卡在同一个地方。Git的下载与安装听起来是最简单的一步实际上却藏着不少选择版本选哪一代、Windows下PATH环境变量怎么处理、换行符转换选哪个、默认编辑器用哪个、SSH密钥要不要现在就配。这些选项如果只是无脑点“下一步”大概率能用但后面提交代码、切换分支、推送到远程仓库时会陆续踩出一堆莫名其妙的坑。这篇把Git系列的第一篇讲透从下载到安装再到基础配置把每个选项背后的原因都讲清楚照着做就行适合刚入行的开发新人、从SVN或TortoiseGit转过来的老同事以及所有想系统学一遍Git的人。1. 先搞清楚Git解决什么问题再下载1.1 这工具到底管什么用Git是一个分布式版本控制系统简单说就是帮你管理代码历史、多人协作、版本回溯的工具。你写了一个文件改了一百遍想看看三天前的版本是什么样Git能给你翻出来你和同事同时改同一个项目各自增删改Git能帮你把两边的改动合并合出冲突了还能逐行对比再决定要哪份。这就是Git存在的意义。需要特别理解的是“分布式”三个字。老牌的版本管理工具SVN是集中式的代码历史存在服务器上离了服务器就什么都干不了Git则每个人本地都有一份完整的仓库历史断网也能提交、也能看日志、也能回滚。这个区别直接决定了你后面用Git的方式——本地操作非常频繁所有历史都在脚下。Windows用户还有个容易混淆的概念Git和GitHub、GitLab不是一回事。Git是工具是本地运行的命令行程序GitHub、GitLab是基于Git的代码托管平台负责把你的仓库放到服务器上方便远程协作。你下载安装的是Git这个工具本身装好之后本地就能用跟有没有GitHub账号没有关系。1.2 安装前先明确自己属于哪种场景不同使用场景安装时侧重点不一样。我一般把使用者分成三类第一类是纯命令行用户日常就是用终端敲git add、git commit、git pull这种场景只要把Git装好、命令行能用就足够安装向导里大部分选项保持默认就好。第二类是IDE用户比如用IntelliJ IDEA、VS Code、Android Studio开发IDE内部自带了Git集成但底层还是要调用系统里的Git可执行文件。这种场景关键在于安装时选对PATH选项让IDE能找到git.exe否则IDEA里会报“Git executable not found”。第三类是刚入门的新手没那么快习惯命令行更想先有图形界面。这类我会建议装完整版Git的同时装一个Git GUI或第三方客户端辅助但Git本身依然要装因为所有GUI工具本质上都是在调用Git的命令行内核。先认清自己属于哪一类后面安装选项就很好选了。2. 下载渠道与版本选择2.1 各平台下载方式对比Git官方提供了所有主流操作系统的安装包下载地址是官网的downloads页面。Windows用户下载.exe格式的安装程序macOS用户下载.dmg安装包Linux用户通常直接用包管理器安装。官网下载有时候速度不太理想这是客观情况。替代方案是走开源软件镜像站国内的阿里云镜像、腾讯云软件源、清华TUNA都提供了Git安装包的同步下载速度快得多而且文件校验和官网一致。我个人的习惯是能用包管理器的优先用包管理器比如macOS的Homebrew、Windows的Chocolatey或winget不熟悉包管理器的直接去镜像站下载安装包最省事。这里有个细节很多人不知道Git官网的Windows下载页面点击下载会推荐一个“64-bit Git for Windows Setup”版本这是最常规的版本别再去翻橱窗里那些Portable版、Minimal版。Portable是绿色便携版不写入注册表适合U盘携带Minimal是精简版很多组件不带上。正经安装用Setup版。2.2 版本选择的两条原则第一条原则不要追新选稳定的最新版。Git的版本迭代比较频繁大版本之间差异并不算大选当前最新的稳定版就行避开RC版、Preview版。看版本号时形如2.4x.x的就是稳定版本如果看到标题里带“rc”或“preview”字样果断跳过。第二条原则32位和64位一定要和操作系统匹配。现在绝大多数电脑都是64位直接下载64位安装包老机器或者特殊系统环境里跑32位的才选32位版本。判断方法很简单右键“此电脑”看系统类型写的是“基于x64的处理器”就选64位。选错位数装上去通常也能装但Git调用外部工具链时很可能出兼容问题。顺带说一句Git在Windows下还有一个特殊版本叫“Git for Windows”其实就是带了一堆Unix工具和Git Bash终端的完整整合包绝大多数Windows教程里说的“下载Git”指的就是它。Linux和macOS用户不需要这个。3. Windows系统安装全程详解每个选项都别乱点3.1 安装向导逐项拆解以Git for Windows 2.x版本的安装向导为例双击安装包后会先看到GNU通用公共许可证说明点Next然后是安装路径选择默认装在C:\Program Files\Git建议保持默认不要装到带中文或空格的路径下后面配环境变量会少很多麻烦。接下来是“Select Components”组件选择界面这是第一个值得看的地方。默认勾选了Git Bash Here、Git GUI Here、Git LFS、Associate .git configuration files等。这几项建议都保留。Git Bash Here是右键菜单里出现“Open Git Bash here”的入口非常实用Git LFS是大文件存储扩展现在仓库里放模型文件、设计稿时经常用到提前装好以后省事。唯一可以取消的是“Scalar”相关组件这是微软贡献的一个大仓库管理工具普通人用不上。然后是“Select Start Menu Folder”默认会在开始菜单创建一个Git文件夹直接Next不用管。接着是“Choosing the default editor used by Git”这是第二个关键选项。默认是Vim如果你会用Vim那没毛病如果不会用强烈建议改成别的编辑器比如Notepad、VS Code或者直接选“Use Visual Studio Code as Gits default editor”。为什么因为后面你执行git commit的时候如果没带-m参数会弹出一个编辑器让你写提交说明Vim的操作逻辑对新人来说极其不友好经常出现“写完不知道怎么保存退出”的惨案。选VS Code就顺畅多了。再往下是“Adjusting your PATH environment”这是整个安装里最重要的一项有三个选项“Use Git from Git Bash only”只在Git Bash里用GitWindows命令行cmd和PowerShell里用不了。“Git from the command line and also from 3rd-party software”推荐把Git装进系统PATHcmd和PowerShell都能直接用IDE也能找到Git。“Use Git and optional Unix tools from the Command Prompt”把Git自带的Unix工具也扔进PATH容易和Windows自带的命令冲突不建议。我强烈建议选第二项“Git from the command line and also from 3rd-party software”。这直接决定了你后面能不能在PowerShell里敲git命令也决定了VS Code、IDEA能不能自动找到Git。然后是“Choosing the SSH executable”——Git自带OpenSSH客户端选第一项就行不需要额外装什么。下面“Choosing HTTPS transport backend”有两个选项Windows系统自带的SSL证书库和Git自带的OpenSSL。Windows原生版在访问某些自签名证书的Git服务器时会和系统证书逻辑更贴合OpenSSL版兼容性更稳。我选第二项OpenSSL遇到的企业内网Git服务器比较多这个选项兼容更好。3.2 容易踩的雷区提醒再往下就是让很多人困惑的“Line Ending Conversions”换行符转换选项这三项值得认真讲讲“Checkout Windows-style, commit Unix-style”推荐把文件检出到工作区时转成CRLFWindows换行符提交时转成LFUnix换行符。“Checkout as-is, commit Unix-style”检出时保持仓库原样提交时转成LF。“Checkout as-is, commit as-is”不做任何转换。对Windows用户来说推荐选第一项。仓库里统一存LFWindows工作区用CRLF这样和同事协作时不会因为换行符差异而产生毫无意义的“整个文件都变了”的diff。只是后面配置.gitattributes时还要再精细控制这个系列以后专门写。这里先记住一个原则仓库内统一LF本地按平台自动转换。然后“Choose a terminal for Git Bash”选MinTTY这是Git Bash的默认终端比Windows自带控制台好用。下面的“git pull”行为选默认的“Fast-forward or merge”就行。接着是“Choose a credential helper”默认是Git Credential Manager一定要保留它让你第一次推代码时弹出窗口登录一次之后账号密码就记住了。最后安装向导会问是否启用文件系统缓存、符号链接等实验性选项。文件系统缓存建议开大仓库性能更好符号链接不要开Windows下手动符号链接权限麻烦用不上。点Install开始安装等进度条走完去掉“View Release Notes”的勾点Finish。3.3 右键菜单和卸载注意事项安装完成后在任意文件夹里点右键应该能看到“Git Bash Here”和“Git GUI Here”两个菜单项。有时候开机后右键菜单没刷新出来重启一下资源管理器就好任务管理器里右键“Windows资源管理器”选择重新启动。卸载Git时有一个坑直接用控制面板卸载后系统PATH里可能还残留Git的路径下次装回新版时如果没清理干净会有“两个Git环境变量冲突”的问题。建议卸载前先去环境变量里把Git相关路径删掉或者干脆重装覆盖安装通常没问题。4. 装完不是结束环境验证与基础配置4.1 验证安装是否成功打开命令行不管是PowerShell还是cmd输入git --version看到git version 2.4x.x.windows.x之类的输出说明Git已经装好并且被系统正确识别了。如果提示“git不是内部或外部命令也不是可运行的程序”说明PATH没配好回到安装向导选“Git from the command line and also from 3rd-party software”重新安装就行不用卸载。再验证一下Git Bash能不能正常打开。在桌面空白处右键选“Git Bash Here”会弹出一个带$符号的命令行窗口。在里面执行git --version同样能输出版本号就说明Git Bash正常。很多人在这里会想“既然Git Bash能用了是不是就不需要Windows Terminal配置了”——其实Windows Terminal里配好了Git Bash路径效率更高这个以后再说现在先确认装好就行。4.2 首次全局配置用户名和邮箱Git每次提交都会记录提交者是谁这个信息来自全局配置。第一次装完必须设置否则以后提交时Git会报错或生成一串不合理的默认身份。打开命令行执行git config --global user.name 你的名字 git config --global user.email 你的邮箱注意两点一是--global表示这台机器上所有仓库默认用这个身份如果你不同的项目要用不同的身份要进到项目目录里再执行git config去掉--global覆盖一次二是邮箱要填你代码托管平台上注册的那个邮箱这样你的提交才会正确关联到你的账号上。配置完了可以检查一下git config --global --list会输出两行user.name和user.email确认没有写反就不会出错。然后是默认分支名的设置。新版Git的默认分支名是master但很多主流的托管平台默认分支名改成了main。为了本地远程一致减少后面切换分支的困扰建议新仓库默认分支设置成maingit config --global init.defaultBranch main这样执行git init时创建的初始分支就叫main和GitHub、GitLab上新建仓库的默认分支名一致推代码时不会出现“本地master远程main”要手动改名的尴尬。4.3 配置SSH密钥强烈建议做的一步用HTTPS方式推拉代码时每次都要输入账号密码或令牌虽然现在有Credential Manager帮我们记住但换新机器、换新令牌后还是麻烦。我更推荐一步到位配好SSH密钥之后推拉代码走SSH协议完全不用输密码。打开Git Bash执行ssh-keygen -t ed25519 -C 你的邮箱一路回车就行。生成的公钥默认在C:\Users\你的用户名\.ssh\id_ed25519.pub。然后用下面的命令把公钥内容打印出来cat ~/.ssh/id_ed25519.pub复制打印出来的整段内容去你用的代码托管平台GitHub、GitLab、Gitee都支持的个人设置里找到“SSH Keys”入口把公钥贴进去保存。以后克隆仓库的时候选SSH协议的地址比如gitgithub.com:用户名/仓库名.git就能免密拉取了。这里要提醒一句还有很多人还在用旧的RSA算法ssh-keygen -t rsa -b 4096。新版的推荐是ed25519安全性更高、密钥短、生成速度快Git for Windows内置的OpenSSH已经支持直接用就好。只要你的服务端版本不是特别老都没问题。5. macOS和Linux用户怎么装5.1 macOS两种安装方式macOS用户分两类。第一类没装Homebrew直接去Git官网下载.dmg安装包双击安装过程中可能会被系统安全策略拦截提示“无法打开因为来自身份不明的开发者”。这个时候去“系统偏好设置-安全性与隐私”里点“仍要打开”就行属于正常现象。第二类装了Homebrew的一行命令解决brew install git装完之后git --version验证同样给Git配置身份git config --global user.name 你的名字 git config --global user.email 你的邮箱macOS的换行符处理比Windows简单因为系统本身就是Unix风格安装时不用选默认的“Checkout as-is, commit as-is”就够用。5.2 Linux一行命令完成Ubuntu、Debian系的用sudo apt update sudo apt install git -yCentOS、RHEL系的用sudo yum install git -y新版CentOS用的dnf写法一样。装完查看版本git --version如果系统源里的Git版本偏旧而你需要新版可以通过源码编译或第三方源安装不过正式环境追求稳定系统源的版本通常也足够。Linux下全局配置和macOS一样设置用户名和邮箱后就能正常工作。另外补一句很多时候Linux服务器上是直接把整个项目clone下来用没有本地开发交互这种情况下Git只需要可执行、有基本身份配置就行其他GUI相关的组件一概用不上。6. 安装和配置中的常见问题排查实录6.1 常见报错速查表现象原因解决办法提示“git不是内部或外部命令”Git未写入PATH重装时选择“Git from the command line and also from 3rd-party software”Git Bash能打开但cmd里用不了安装时选了仅Git Bash使用手动把Git安装目录的cmd文件夹加入系统PATH双击安装包没反应安装包下载不完整或杀毒软件拦截重新下载安装包临时关闭实时防护再安装git --version报错“无法定位程序输入点”系统缺少运行库安装Git依赖的VC运行库或更换更新的Git版本提交时提示“Please tell me who you are”没配置user.name和user.email执行全局配置命令右键菜单里没有Git Bash Here组件未勾选或右键菜单缓存问题重装时勾选Git Bash Here组件重启资源管理器这个表里的场景我几乎全遇到过。最典型的是第一条很多人下载了安装包安装时没注意PATH选项装完PowerShell里一敲git直接报错。重装是我最推荐的办法别去手动改环境变量改来改去很容易把路径写错。手动改的话要新增一条指向C:\Program Files\Git\cmd的PATH路径而不是C:\Program Files\Git\bin这是很多人改完仍然失败的原因bin目录里并不一定有git.exe。6.2 换行符隐藏大坑换行符问题在安装后的第一次协作中特别容易暴露。明明只改了一行代码提交时diff却显示整个文件几百行全部变动十有八九是换行符在作怪。Windows下Git默认会把仓库里的LF转成CRLF再检出如果某个文件被编辑器或工具保存成了纯LF格式或者队里有人用Linux、macOS提交过两边的换行符混在一起diff就会变得极不可读。解决办法是两层。第一层是安装时选择“Checkout Windows-style, commit Unix-style”第二层是在仓库里加一个.gitattributes文件对特定目录、特定文件类型做硬性约定比如文本文件统一LF、二进制文件声明为binary。这个文件的内容和写法到讲“Git四件套”那篇再展开这里只要记住以后看到“整个文件都被改动”的diff先怀疑换行符。6.3 关于Credential Manager的取舍Windows安装时默认勾选了Git Credential Manager这个工具会在你第一次通过HTTPS推拉代码时弹出一个窗口让你在浏览器里授权或者输账号密码。很多人不习惯觉得多此一举我反而推荐保留它。我见过太多人第一次推代码时在命令行里输了一百遍密码结果Windows凭据管理器里还存了个旧密码导致每次都被拒绝认证。用Credential Manager的正确心态是它是一个安全的本地凭据保险箱帮你把令牌存起来不用每次输。如果你用它还是反复要求认证去“控制面板-凭据管理器-Windows凭据”里找到git开头的凭据删掉重新授权一次即可。这个小操作我帮同事排查过不下五次都是旧凭据在作怪。6.4 遇到问题时别急着重装最后一条经验很多人遇到一点问题就卸载重装其实多数安装问题都不用重装。Git的安装相对非常轻量重装成本低但要先确认是不是配置问题。一个比较高效的排查思路是先用git --version确认工具本身可用再用git config --list看配置是否正确最后再看远程仓库地址和凭据状态。按这个顺序来90%的问题都能定位根本不需要动安装程序。7. 安装好了之后接下来学什么Git的下载与安装是一切的基础装好了之后你会发现后续所有操作都建立在这套环境上。我建议下一步去实操几个最常用的命令git init初始化仓库、git add暂存改动、git commit提交历史、git log查看提交记录把这条本地闭环跑通。实战中每个人踩的坑顺序都差不多第一次提交忘记配置身份第一次推送被凭据卡住第一次合并冲突手足无措。遇到这些问题时别慌Git的命令行报错已经算比较友好的了多看几遍报错信息对照这个系列后续的内容慢慢来很快就能上手。最后再分享一个小技巧第一次配完环境之后可以用git help查看帮助文件系统里其实自带了完整文档遇到不会的命令先git help 命令名看看比上网乱搜靠谱得多。