很多人把“安装 Git”当成双击 exe 然后一路 Next 的小事但我见过太多人三个月后栽在安装时埋下的坑里提交历史里用户名全是乱码、中文文件名显示成一堆\345\274\240、或者 IDE 死活找不到 Git 可执行文件。这篇是 Git 系列的第一篇专门解决“从 0 到 1 把 Git 装对”这件事。我会把 Windows、macOS、Linux 三种平台的下载安装路径、安装向导里每一项选择的真实含义、装完必须做的基础配置、以及我踩过和帮别人排过的典型安装问题全部过一遍。这篇适合所有刚开始接触 Git 的人也适合那些“装是装了但从没认真看过安装选项”的同学——如果你打算用 Git 管自己的代码、跟着开源项目学习、或者未来要和别人协作写项目这十几分钟读下来能省掉后面大量的折腾时间。1. 为什么值得认真对待“装 Git”这件事1.1 安装只是起点配置才是分水岭先说个观察。很多人问“Git 怎么装”实际想问的是“怎么把 GitHub 上的项目下载下来”。但 Git 是一个分布式版本控制系统它的核心能力是”管理你自己的代码历史”下载别人的代码只是一个附带功能。所以如果只把它当下载工具装完之后很快就会遇到各种别扭的时刻改了文件却不知道怎么看差异、想回退却发现历史一团乱麻、提交之后作者信息全是错的。真正决定 Git 好不好用的不是安装包本身而是装完之后那几分钟的配置。用户信息配置错了后面每一次提交都会留下不可追溯的脏数据换行符策略没选对跨平台协作时会在 diff 里看到满屏的”假改动”中文文件名的显示配置缺失会看到一串转义后的八进制乱码。这些都不是 Git 本身的 bug而是安装阶段没有想清楚。1.2 下载渠道怎么选官网、镜像、包管理器Git 的官方下载站在git-scm.com/downloads界面简单各平台入口都在一个页面上。对于大部分国内用户来说直接访问官方站有时会慢尤其 Windows 的安装包接近 60MB。这时候可以选择腾讯云、阿里云、华为云这类软件镜像站它们都会同步 Git for Windows 的最新版本速度通常比官网快很多。镜像站下载要注意一个点认准文件名里的版本号和架构。比如Git-2.47.1-64-bit.exe就是 64 位 Windows 版Git-2.47.1-32-bit.exe是 32 位版。现在的电脑基本都能跑 64 位除非你的机器特别老或内存小于 4GB否则直接选 64 位即可。macOS 和 Linux 用户则可以考虑另一条路线用系统生态里的包管理器比如 Homebrew、apt、dnf。这条路的好处是后续升级方便一条命令搞定缺点是版本可能不是最新。Git 这个工具的更新节奏没那么激进只要不是太旧的版本日常使用几乎无感。所以我的建议是桌面端用户直接用官方安装包命令行为主的用户用包管理器怎么省事怎么来。2. Windows 平台下载源与安装向导的逐项拆解2.1 下载前要明白“Git for Windows”是什么Windows 上装的 Git正式名字叫 Git for Windows它不是一个简单的命令行工具移植而是一个完整的环境套件里面包含真正的 Git 核心命令git开头的那些Bash 模拟环境也就是安装后右键能看到的“Git Bash Here”常用的 Unix 小工具ls、grep、sed、awk等SSH 客户端、GNU 加密库、证书库等底层依赖很多人不理解为什么 Git 在 Windows 上要捆绑一个 Bash。原因其实很简单Git 本身是 Linux 生态里长出来的工具大量操作习惯都建立在 Shell 环境之上。你在网上看到的很多 Git 教程命令行里的操作比如mkdir、cd、cat在 Windows 自带的 CMD 里是另一套写法。Git Bash 把人拉回熟悉的 Unix 环境这样教程怎么说、你就怎么敲不会被 Windows 的语法差异打扰。这也是我这么多年一直推荐 Windows 用户在 Git Bash 里学 Git 的原因。2.2 安装向导里那些“默认选项”的真实含义Git for Windows 的安装向导其实只有几步但每一步都不是摆设。以下是我认为必须理解清楚的几个界面。Select Components组件选择默认勾选基本合理。还有一个容易忽略的选项是“Add a Git Bash Profile to Windows Terminal”如果你用的是 Windows 11 自带的 Terminal建议勾上这样之后可以在终端下拉菜单里直接打开 Git Bash比右键菜单更顺手。其它比如每日检查更新、把 Git 加入 PATH默认即可。Default editor默认编辑器这里默认是 Vim但我认真劝退新手选 Vim。因为当你执行git commit而没有附带-m参数时Git 会打开这个编辑器让你填写提交说明。Vim 的退出方式按Esc输入:wq对没接触过的人来说完全是玄学。我见过一个同学卡在 Vim 里半小时出不来原因就是不知道怎么保存退出。装的时候建议直接选其他选项如果机器上有 VS Code 就选 VS Code有 Notepad 就选 Notepad实在不行选 Nano 也比 Vim 友好。当然这个选项装完后也可以用命令随时改不用紧张。Adjusting your PATH environmentPATH 环境变量这是整个安装向导里最关键的决策点。它有三个选项Git from the command line and also from 3rd-party software推荐把 Git 的核心命令加入系统 PATH这样 CMD、PowerShell、各种 IDE 都能调用git命令。Use Git from Git Bash only只在 Git Bash 里能用CMD 和 IDE 里无法使用。Use Git and optional Unix tools from the Command Prompt不仅加入 Git还把 Unix 工具也暴露给 CMD。这个选项最不推荐因为它会用 Unix 的find、sort等命令覆盖掉 Windows 同名的系统命令可能引发奇怪的系统行为。我只说一句选第一项。很多 IDE 报“无法检测到 Git”根源就是装的时候选了第二项。Line ending conversions行尾转换策略这个选项和跨平台协作有关。Windows 用CRLF作为换行符macOS/Linux 用LF如果两边都不转换Git 会认为每个文件都改了。这儿的三个选项含义分别是Checkout Windows-style, commit Unix-style推荐检出代码到 Windows 时自动转成CRLF提交回仓库时转成LF。这是最常见的推荐配置。Checkout as-is, commit Unix-style检出时保持原样提交时转成LF。适合你确定仓库里不会混入CRLF的情况。Checkout as-is, commit as-is不做任何转换要求团队所有人自觉使用统一的换行符。对新手我的建议是选第一个别多想。装完后续也可以靠git config core.autocrlf调整策略我在第 4 章再细讲。Terminal emulator终端模拟器这里二选一MinTTY和Windows Console。MinTTY 是 Git for Windows 默认推荐项支持彩色输出、快捷键更丰富在 Git Bash 里敲命令的体验好很多。Windows Console 则和旧版终端外观一致兼容性优先但功能朴素。对日常使用选 MinTTY 就对了。Git Credential Manager凭据管理器默认勾选。它的价值在于当你通过 HTTPS 方式推送代码到 GitHub、GitLab 这类平台时Git 会弹出登录窗口输入账号密码或令牌后凭据会被安全保存下次操作不再重复输入。如果不装它每次 push 都可能要求你重新认证非常折磨。所以这一项务必保留。其余选项像 symbolic link 支持、文件系统缓存、实验性功能保持默认即可。实验性功能我建议不勾因为那些特性还在打磨没必要用自己日常环境去试错。2.3 安装完成后的第一眼检查装完后桌面不会有快捷方式图标这是很多人“以为自己没装成功”的原因。实际上你应该做这几步验证在任意文件夹空白处点击右键菜单里出现Open Git Bash here和Open Git GUI here说明安装成功。打开 Git Bash输入git --version能看到类似git version 2.47.1.windows.1的输出。再输入which git能返回一个实际路径比如/c/Program Files/Git/cmd/git。这里有一个 Windows 特有的小细节右键菜单里的 Git Bash Here打开之后默认就停留在当前目录这是后续所有仓库操作最常用的入口。我建议从今天开始凡是和 Git 有关的本地操作都从这个入口进而不是去系统搜索框里找 Git Bash 再cd半天。3. macOS 和 Linux两条完全不同的安装路径3.1 macOS三种方式优先级怎么排macOS 用户装 Git 通常有三条路Apple 提供的 Command Line Tools命令行开发者工具在终端里执行xcode-select --install系统会弹窗引导安装。装完自带一个 Git但版本往往偏旧。优点是系统级集成缺点是版本落后而且一些需要新语法特性的命令会提示不支持。官方 pkg 安装包从git-scm.com/download/mac下载双击安装。这种方式会装一个独立的、较新的 Git并默认放置在一个独立目录比如/usr/local/git/bin。安装时系统可能提示“未验证的开发者”之类需要到系统设置的安全性与隐私里允许打开。对不习惯命令行的同学这条路最直观。Homebrew如果日常使用 macOS 已经装了 Homebrew一条brew install git就能拿到当前稳定版。这也是我个人最推荐的方式理由只有一个后续升级方便。brew upgrade git一行搞定不用重新下载安装包也不用担心系统残留旧版本。这里有个常见误区明明用了brew install git重启终端后git --version显示的还是旧版。原因通常是系统自带的 Git 路径/usr/bin/git被优先搜索到了。可以用which git和type -a git查看顺序必要时用export PATH/usr/local/bin:$PATH或 Homebrew 提示的路径来调整环境变量优先级。如果你不想折腾最简单的办法是把官方 pkg 和 Homebrew 二选一不要混装。3.2 Linux包管理器命令背后的差异Linux 发行版众多命令不尽相同但思路一致从官方软件源安装。Debian / Ubuntu 系sudo apt update sudo apt install gitRHEL / CentOS 7 及以下、Fedora 早期版本sudo yum install gitFedora、RHEL 8sudo dnf install gitArch / Manjarosudo pacman -S git装完后同样用git --version验证。Linux 下遇到最多的问题是“官方源里的 Git 版本太旧”比如某些长期支持版系统自带的 Git 可能还在 2.7 甚至更低很多新特性完全没有。遇到这种情况可以考虑从源码编译但我不建议日常用户这么做——编译 Git 会引入大量依赖编译过程耗时且容易出错。更稳妥的做法是添加第三方源比如针对 Ubuntu 的 Git PPAppa:git-core/ppa或者直接下载官方编译好的二进制包。对绝大多数日常开发需求来说系统源里的版本已经够用了。还有一点提醒如果你是以 root 用户安装记得思考一下是否需要给普通用户也做配置。Git 的全局配置存储在用户主目录的~/.gitconfig文件里root 用户配置的 user.name 和 user.email 不会自动同步到普通用户。多用户共用机器时最好每个人各自执行一次配置命令否则两个用户提交的代码会混成同一个身份。4. 装完先别急着 commit第一次配置决定后面所有提交4.1 提交身份Git 怎么知道“你”是谁安装完成后第一件事不是打开 Git 对项目 init而是告诉 Git 你是谁。执行git config --global user.name 你的名字 git config --global user.email 你的邮箱这里的--global表示全局生效写入的是用户主目录下的~/.gitconfig文件。配置完成后的每次提交Git 都会把这个名字和邮箱写入提交记录成为历史的一部分。有人觉得“反正都是自己一个人在写随便填一个呗”。我不建议这么做因为提交身份是会长期留在仓库历史里的。如果填错或者填了别人的信息后面想去改就要动用git filter-branch之类的大规模历史重写工具麻烦且危险。最好从第一天就用真实常用、且和你代码托管平台账号一致的邮箱这样提交记录能正确关联到你的账号上贡献图才不会乱。配置验证也很简单git config --global --list输出里能看到刚才设置的内容。如果拼错了重新执行一次配置命令即可最后一次写入的会覆盖旧值。4.2 跨平台换行符为什么别人的项目一克隆就“全改了”我在第 2 章提到过安装向导里的行尾选项那是安装层面。装完之后还可以靠命令再次确认和调整。Windows 用户建议git config --global core.autocrlf truemacOS / Linux 用户建议git config --global core.autocrlf input这个配置的作用是true模式在检出文件时把LF转成CRLF提交时把CRLF转回LFinput模式检出时不做转换但提交时仍然把CRLF转成LF。简单理解就是仓库内部永远存LF保证跨平台一致工作区的换行符按当前系统的习惯来Windows 用户编辑文件不会遇到换行符报错macOS/Linux 用户也不会有多余的转换负担。这配置没做会怎样我就见过一个实际案例。一个团队里 Windows 和 macOS 同学各自提交Windows 同学保存文件时编辑器把换行符全部变成CRLF并提交进仓库macOS 同学拉下来一看git diff显示所有文件都变了实际内容却一行没动。这种“假 diff”会导致 code review 极其痛苦严重的可能把别人的改动淹没在换行符噪声里。4.3 中文相关的两个配置文件名和日志显示如果你是中文用户强烈建议执行git config --global core.quotepath falseGit 默认会对非 ASCII 的文件名做八进制转义比如一个叫测试.txt的文件在git status里会显示成\346\265\213\350\257\225.txt完全没法读。设置core.quotepath false之后中文文件名能正常显示。这个配置对日常使用体验影响极大却极少出现在新手教程里。另外如果 Git 输出的中文内容出现乱码通常是终端编码和 Git 的编码不匹配。Git Bash 环境下一般问题不大如果用系统 CMD可以尝试把终端代码页切到 UTF-8chcp 65001。Linux/macOS 终端基本天然支持 UTF-8很少遇到这类问题。4.4 安装成功与否的完整验证清单配置完成后我建议按这个清单做一轮完整的体检git --version—— 能看到版本号确认命令可用。git config --global --list—— 能看到 user.name、user.email 等核心配置确认身份无误。找一个临时目录执行git init确认生成了.git文件夹此时 Git 仓库创建成功。在该目录新建一个文件执行git add .和git commit -m first commit确认提交成功再执行git log --oneline能看到一条提交记录且作者名和邮箱是你配置的。在项目目录里随便乱改一个文件后执行git diff确认中文显示正常、换行符没有产生多余的干扰。到这里Git 才算真正装好、配好了。很多教程在这步就收尾但真实的安装流程中还有几个高频问题值得单独拿出来讲。5. 安装之后我经常被问到的几个问题与排查思路5.1 明明装好了CMD 里却提示“git 不是内部或外部命令”这个报错最直接的原因是安装时 PATH 环境变量没有配置成功或者安装后没有重启终端。先确认安装时是否选了“Git from the command line and also from 3rd-party software”。如果选了但依然不行按Win R输入sysdm.cpl打开环境变量设置窗口在“系统变量”的Path里查找是否有C:\Program Files\Git\cmd这一条。如果存在问题大概率是当前终端没有重新加载环境变量——CMD 或 PowerShell 启动时读取环境变量窗口开着就是旧值关掉重开即可。如果是 IDE 内嵌终端、或者某些编辑器里报同样错误则需要重启整个 IDE让进程重新读取环境变量。还有一个隐蔽情况安装了多个版本的 Git或者手动修改过 PATH 导致C:\Program Files\Git\cmd被其他目录里的git.exe抢占。排查时可以执行where gitWindows 会按 PATH 顺序打印所有匹配到的 git 路径看看到底是哪一个被优先调用。5.2 IDE 显示“无法检测到 Git”但命令行里明明能用这通常不是安装问题而是 IDE 默认没有自动找到 Git 的可执行文件。以 IntelliJ 系列为例在File Settings Version Control Git里Path to Git executable应该指向C:\Program Files\Git\cmd\git.exe确保路径正确后点“Test”可以验证。VS Code 则更简单只要系统 PATH 正确重启一下 VS Code 就能识别如果还不行可以在设置里明确指定git.path。这个问题的本质是IDE 不调用 PATH 里的git而是直接找特定路径或者依赖启动时的环境变量快照。所以排查思路永远是先确认命令行git --version正常再确认 IDE 的 Git 路径配置指向正确的可执行文件最后重启 IDE。百分之九十的问题都出在这三步之内。5.3 Git Bash 里中文乱码、命令补全不生效之类的小别扭中文乱码分两种情况一种是git status里的中文文件名单显示为转义序列这个靠第 4 章说的core.quotepath false解决另一种是终端输出乱码这个要看 Git Bash 的字体和编码设置。Git Bash 的窗口菜单里选择“Options Text”将字符集设为 UTF-8字体换成中文字体兼容的即可。关于命令补全Git Bash 本身已经内置了 git 命令和分支名的 Tab 补全不需要额外配置。如果你用的是 PowerShell可以装 posh-git让提示符里直接显示当前分支和未提交状态。这个属于体验优化不想折腾也不影响任何实际功能。5.4 下载慢、中断、校验失败怎么办Windows 安装包下载慢或中途失败最简单的办法是换镜像源前面提到的几个云厂商软件镜像一般都有同步。下载完成后如果担心安装包损坏可以在官网页面找到 SHA-256 校验值把本地文件的哈希算出来对比一下。注意安装包版本不同校验值也不同务必与该版本对应匹配。6. 安装过程中的两点个人体会装 Git 这件事说实话技术难度很低真正重要的其实是“理解每个选项在做什么”。安装时随手选错一个可能在几个月后才以诡异的方式爆发。我在给身边人做技术支持时见过太多例“提交人是谁都不知道”“一个文件 diff 出一千行”“推不上去一直让输密码”的问题追根溯源都是装的时候没有看过选项的含义。这篇把下载安装和首次配置讲透了后面 Git 系列我会开始讲真正让这个工具发挥价值的部分仓库的生命周期、add/commit/log 这组日常命令的使用逻辑、分支管理与合并策略还有协作场景里最见功底的 pull request 和冲突解决。你可以先把这篇当作一个稳妥的地基确保自己的 Git 环境是健康的再往后走就不会被各种莫名其妙的环境问题绊倒。