1. 为什么2025年还要认真装一次Git先把结论摆在前面Git不是“装完就能用”的软件装完之后那几行配置才是决定你后面半年会不会被换行符、中文乱码、提交署名搞到崩溃的关键。我见过太多人git --version能打印出版本号就以为万事大吉结果第一次跟人协作提交记录里全是unknown或者 Windows 上拉下来的脚本在 Linux 里跑不起来回头查半天才发现是安装时一个默认选项没改。这篇内容就是围绕“2025年把Git装对、配好”这件事展开的。它适合三类人刚接触版本控制、准备在 Windows 或 macOS 上从零装一遍的新手装过但配置一团糟、想推倒重来的半熟手以及需要在多台机器、多个代码托管平台之间来回切换的开发者。我会把安装路径、组件选择、核心配置、验证方法、常见坑全部拆开讲每一步都告诉你“为什么这么选”而不是甩一张截图让你照点。需要说明的是Git的安装包每年都在小步更新2025年的安装向导相比几年前多了几个选项比如默认分支名的选择、凭证管理器的集成方式但底层逻辑没变。下面涉及具体界面文字的地方我会以当前主流版本为准如果你的向导文字略有出入按同样的判断逻辑走就行。2. 安装前的整体思路与版本选型2.1 先搞清楚你要的是哪种Git很多人不知道Git在不同系统上的“形态”是不一样的这直接决定了你该怎么装。在Windows上官方推荐的是 Git for Windows它自带一个叫 Git Bash 的终端环境让你在 Windows 里也能用类 Unix 的命令行操作。这是绝大多数 Windows 用户的首选因为它把 Git 本体、Bash 环境、凭证管理器打包在一起装一次全都有。在macOS上情况稍微特殊。系统自带了一个精简版的 Git但版本往往偏旧而且缺少一些工具。正规做法是通过包管理器安装完整版或者直接下载官方安装包。如果你用 Homebrew一条命令就能搞定如果不想装 Homebrew就去官网下独立安装包。在Linux上基本都用发行版自带的包管理器比如 Debian 系用aptRed Hat 系用dnf或yum。这个最省心但要注意版本有些老发行版的默认源里Git版本很低可能需要额外添加源。提示不要为了“最新版”去编译源码除非你有明确的版本需求。对99%的人来说官方安装包或包管理器里的稳定版完全够用编译源码反而容易踩依赖的坑。2.2 版本号怎么挑Git的版本号是主版本.次版本.修订号这种格式。2025年主流稳定版已经到 2.4x 系列。选版本的原则很简单选最新的稳定版但不要选刚发布没几天的。刚发布的大版本偶尔会有回归问题等一两周让社区先踩一遍更稳妥。如果你是在企业环境里还要考虑团队统一。团队里有人用 2.30有人用 2.45大部分功能没问题但涉及一些新特性比如某些git worktree的改进、git switch的增强时可能行为不一致。所以团队最好约定一个最低版本比如“不低于 2.40”。2.3 安装方式对比系统推荐方式优点注意点Windows官方 Git for Windows 安装包组件全、带 Bash、带凭证管理器向导选项多别一路下一步macOSHomebrew 或官方安装包版本新、易升级系统自带版本别直接用Linux发行版包管理器省心、自动处理依赖老发行版版本可能偏低这张表看着简单但每一条背后都有故事。比如 Windows 上为什么强调“别一路下一步”因为向导里有个关于换行符的选项默认值在不同版本里改过选错了后面跨平台协作就是灾难。这个我在第4节会详细展开。3. Windows平台图文级安装实操3.1 下载与启动安装向导去 Git 官方网站的下载页它会自动识别你的系统并推荐对应版本。2025年的页面通常会给你两个选择Standalone Installer独立安装包和Portable便携版。选独立安装包便携版适合放U盘里随身带、不想写注册表的场景但日常开发不推荐因为它不会自动配置环境变量。下载下来是个.exe文件双击启动。第一屏是许可协议看完点下一步。第二屏是安装路径默认是C:\Program Files\Git。这里有个小建议路径里不要有中文和空格。虽然现在Git对中文路径的支持好了很多但某些老工具链、某些脚本在处理带空格路径时还是会出问题。如果你C盘空间紧张可以改到D盘但同样保持纯英文路径。3.2 组件选择哪些必须勾哪些可以省组件选择这一屏默认勾选的是几个核心项我逐个说Additional icons桌面快捷方式和快速启动栏图标。桌面图标可勾可不勾看你习惯。Windows Explorer integration这个建议勾上它会在右键菜单里加“Git Bash Here”和“Git GUI Here”。前者极其好用你在任意文件夹右键就能打开Git Bash省得手动cd。Git LFS大文件存储支持。如果你会往仓库里放图片、视频、模型文件勾上。纯写代码的话不勾也行后面可以单独装。Associate .gitconfiguration files with the default text editor*把.gitconfig这类文件关联到默认编辑器。建议勾方便直接双击改配置。Associate .sh files to be run with Bash把.sh脚本关联到Git Bash运行。看你是否经常写shell脚本可勾可不勾。Use a TrueType font in all console windows控制台字体优化勾上中文显示会好看些。下面还有两个关于凭证和符号链接的选项Enable experimental support for pseudo consoles这个在新版本里已经比较稳定了勾上能让某些交互式程序在Git Bash里正常显示。Enable symbolic links需要管理员权限如果你不确定先不勾后面需要再开。3.3 默认编辑器怎么选这一屏是很多人纠结的地方。选项通常有 Vim、Nano、Notepad、Visual Studio Code 等。我的建议很直接如果你不熟悉Vim千万别选Vim。Git在需要你输入提交信息、解决合并冲突时会调起这个编辑器Vim的操作模式对新手极不友好进去出不来是常态。选Visual Studio Code是最省事的前提是你已经装了VS Code。如果没装选Notepad或者直接用系统记事本也行。选完之后Git需要你写多行信息时会自动打开对应编辑器保存关闭即可完成。注意这个选项只是设置默认编辑器不影响你日常在IDE里提交代码。它只在命令行操作需要编辑文本时生效。3.4 换行符处理整个安装最关键的一步这一屏叫“Adjusting your PATH environment”之后的“Configuring the line ending conversions”是整个向导里最不能选错的地方。背景是这样的Windows用CRLF回车换行表示换行Unix/Linux/macOS用LF换行。如果不管跨平台协作时就会出现“整个文件都显示被修改了”的诡异现象其实只是换行符不同。三个选项的含义Checkout Windows-style, commit Unix-style line endings拉取代码时转成CRLF提交时转回LF。这是Windows上的推荐选项适合大多数在Windows上开发、但代码要跟Linux服务器或macOS同事协作的场景。Checkout as-is, commit Unix-style line endings拉取时不转换提交时转LF。适合你主要在Unix-like环境里工作偶尔用Windows。Checkout as-is, commit as-is完全不转换。除非你有特殊需求否则别选跨平台必出问题。选第一个然后继续。3.5 终端模拟器与凭证管理器接下来是选择Git Bash使用的终端模拟器通常选MinTTY它比Windows自带的控制台好用支持更好的字体渲染和窗口缩放。然后是凭证管理器选Git Credential Manager。这个东西的作用是帮你安全地保存代码托管平台的登录凭证省得每次推送都输密码。2025年的版本对各大平台的OAuth支持都很完善选它没错。最后几个选项Enable file system caching勾上能提升大仓库的操作速度Enable Git Credential Manager已经包含在前面了。剩下的实验性选项保持默认即可。点安装等进度条走完勾选启动Git Bash完成。3.6 验证安装是否成功打开Git Bash输入git --version正常会输出类似git version 2.45.1.windows.1的内容。如果提示“command not found”说明环境变量没配好大概率是安装时PATH选项选错了。回去重新运行安装程序在PATH那一屏选Git from the command line and also from 3rd-party software。再验证一下换行符配置git config --global core.autocrlf应该输出true说明前面的选择生效了。4. macOS与Linux的安装路径4.1 macOSHomebrew一条命令的事如果你已经装了Homebrew打开终端brew install git装完之后which git应该指向/opt/homebrew/bin/gitApple Silicon或/usr/local/bin/gitIntel。如果指向/usr/bin/git说明系统自带的那个优先级更高需要调整PATH把Homebrew的路径放到前面。不想装Homebrew的话去官网下载macOS安装包双击.dmg运行里面的.pkg一路继续即可。安装包会自动处理PATH。macOS上有个细节系统自带的Git在首次运行时会弹窗让你安装“命令行开发者工具”那个过程很慢而且装的版本旧。所以先装完整版Git再运行git --version就不会触发那个弹窗了。4.2 Linux包管理器直接上Debian/Ubuntu系sudo apt update sudo apt install gitRed Hat/CentOS/Fedora系sudo dnf install git装完git --version验证。如果版本太老比如低于2.30可以考虑添加官方维护的PPAUbuntu或使用源码编译但对大多数人来说发行版自带的版本够用。Linux上不需要纠结换行符因为默认就是LF。core.autocrlf保持默认的false即可。5. 装完必做的核心配置5.1 身份配置别让提交记录变成匿名装完第一件事配置用户名和邮箱git config --global user.name 你的名字 git config --global user.email 你的邮箱这两行信息会写进每一个提交记录里。邮箱最好跟你代码托管平台注册的邮箱一致这样平台才能把你的提交跟你的账号关联起来贡献图才会亮。提示如果你在公司和个人的项目用不同身份可以针对单个仓库覆盖全局配置在仓库目录里执行不带--global的同名命令即可。5.2 默认分支名main还是master2025年新装的Git默认分支名大多已经是main了。但如果你跟老项目协作可能还是master。可以显式设置git config --global init.defaultBranch main这样git init出来的新仓库默认分支就是main。跟老仓库协作时拉取下来的分支名以远程为准不受这个配置影响。5.3 别名把常用长命令缩短Git命令有时候很长配置别名能省不少事。几个我常用的git config --global alias.st status git config --global alias.co checkout git config --global alias.br branch git config --global alias.lg log --oneline --graph --all配完之后git st就等于git statusgit lg能看一张漂亮的提交图。别名是个人习惯不用照抄挑你高频使用的命令配就行。5.4 凭证缓存少输几次密码Windows上装了Git Credential Manager之后基本不用管。macOS上可以用钥匙串git config --global credential.helper osxkeychainLinux上可以用缓存模式git config --global credential.helper cache默认缓存15分钟可以改成更久git config --global credential.helper cache --timeout36005.5 查看所有配置配置完之后用这条命令检查git config --global --list它会列出所有全局配置项。如果发现哪条写错了用git config --global --unset 配置项名删掉重来。6. 常见问题与排查速查6.1 中文文件名显示为八进制转义在Git Bash里git status中文文件名显示成\346\226\207\344\273\266这种。解决git config --global core.quotepath false这个配置告诉Git不要对非ASCII字符做转义直接显示原始字符。6.2 提交时提示“Please tell me who you are”说明用户名和邮箱没配。按5.1节配置即可。如果配了还提示检查是不是在某个仓库里配了空值覆盖了全局配置用git config --list看看当前生效的值。6.3 拉取代码时提示冲突但不知道从哪下手先git status看哪些文件冲突打开冲突文件会看到、、标记。手动编辑保留需要的内容删掉标记然后git add该文件再git commit完成合并。如果搞乱了想重来git merge --abort可以回到合并前状态。6.4 Git Bash里运行某些命令没反应或乱码大概率是终端编码问题。在Git Bash窗口标题栏右键选Options在Text里把Locale设为zh_CNCharacter set设为UTF-8。另外某些交互式程序需要伪终端支持确认安装时勾了“Enable experimental support for pseudo consoles”。6.5 推送大文件失败Git对单个文件大小有限制超过一定大小会被拒绝。如果确实需要管理大文件安装Git LFSgit lfs install git lfs track *.psd然后把.gitattributes一起提交。注意LFS需要托管平台支持主流平台都支持但免费额度有限。问题现象可能原因解决方法中文名转义core.quotepath默认true设为false提示匿名提交未配user.name/email配置全局身份换行符全文件变更autocrlf设置不当Windows设true推送被拒文件过大或权限不足用LFS或检查凭证命令找不到PATH未配置重装选对PATH选项6.6 一个容易被忽略的坑大小写敏感Windows和macOS的文件系统默认大小写不敏感Linux敏感。这意味着你在Windows上把File.txt改成file.txtGit可能认为没变化。解决git config --global core.ignorecase false但要注意这个配置在某些Windows环境下可能引发其他问题改之前先确认你的项目没有依赖大小写不敏感的行为。7. 我踩过的几个真实坑第一个坑是换行符。早年我在Windows上装Git向导一路下一步core.autocrlf被设成了false。结果跟Linux服务器上的同事协作每次拉取都提示几十个文件被修改diff一看全是换行符差异。后来改成true才消停。这件事让我明白安装向导里那些看似技术性的选项每一个都对应着真实的协作场景。第二个坑是编辑器。我一开始选了Vim结果第一次git commit没带-m参数直接掉进Vim里按了半天不知道怎么退出最后强制关窗口。后来改成VS Code世界清净了。所以我现在给别人的建议都是不熟Vim就别选这不是逞能的地方。第三个坑是凭证。有段时间我频繁切换两个代码托管平台的账号凭证管理器记住了旧的推送一直失败。后来在Windows的“凭据管理器”里手动删掉对应条目重新推送时才会弹窗让你登录新账号。这个操作在图形界面里不好找但关键时刻能救命。第四个坑是路径。我有次把Git装在了带中文的路径下平时没事但某个构建脚本调用Git时死活找不到可执行文件。查了半天才发现是脚本对中文路径处理有问题。从那以后所有开发工具的安装路径我都保持纯英文。8. 装完之后建议立刻做的几件事装好Git只是起点下面这几件事做完你的日常开发会顺很多。第一去代码托管平台配置SSH密钥。虽然凭证管理器能处理HTTPS的登录但SSH在某些场景下更方便尤其是需要频繁操作多个仓库时。生成密钥的命令是ssh-keygen -t ed25519 -C 你的邮箱然后把公钥内容贴到平台的SSH设置里。测试连接用ssh -T git平台域名。第二配一个好看的日志格式。前面提的git lg别名只是基础版你可以根据自己的喜好调整颜色、日期格式、作者显示等。这个投入一次后面每天看提交历史都舒服。第三养成提交前git status和git diff的习惯。这两个命令能让你清楚知道哪些改动要提交、哪些是误改。我见过太多人git add .一把梭结果把临时文件、编译产物全提交上去了。配一个合适的.gitignore模板能省掉大量清理工作。第四如果你用VS Code或JetBrains系列IDE确认它们识别到了你新装的Git。通常在设置里搜“Git Path”指向你安装的可执行文件即可。IDE内置的Git图形界面能覆盖大部分日常操作但底层还是调用命令行Git所以命令行版本装对了IDE里才不会有奇怪的问题。关于后续扩展Git的配置远不止这些。比如你可以配置diff工具用Beyond Compare配置merge工具用KDiff3配置git worktree来同时检出多个分支到不同目录。这些都属于进阶用法等你把基础流程跑顺了再折腾不迟。我个人的原则是先把提交、拉取、推送、分支切换这四个动作练到不用查文档再去碰那些花哨的功能。基础不牢工具越多越乱。