Git for Windows 安装:向导里 3 个关键选项一次选对,装完 git 就能用

2026-10-24

标签Git官方下载引导软件 bug

Git for Windows 从 git-scm.com/download/win 下载,页面会自动开始取最新 64 位安装包。安装向导选项虽多,真正决定「装完能不能用」的只有 PATH 一个选项,另外两个值得顺手改:默认编辑器和初始分支名。装完用 git --version 验证成功,第一次提交前还要设置 user.name 和 user.email。

下载:官方地址与两种版本

官方下载地址是 git-scm.com/download/win,域名以 git-scm.com 结尾即为官方页面,打开后几秒内会自动开始下载;没有自动开始就在页面上找「64-bit Git for Windows Setup」这一行手动点击,32 位老机器才选 32-bit。页面上还有一种 Portable Git(便携版),解压即用、不写注册表,适合 U 盘和公共电脑,但它不会自动更新,长期使用还是装正式安装版。需要指定历史版本时,用官方发布仓库 git-for-windows 的 GitHub releases 页面,按版本号目录找对应文件。

向导里的第一个关键选项:PATH

安装向导走到「Adjusting your PATH environment」这一步,三个选项的区别直接决定命令行能不能用 git。选第一项「Git from the command line only」只能在 Git Bash 里用 git,在 CMD、PowerShell 里输 git 会提示不是内部或外部命令;选第二项「Git from the command line and also from 3rd-party software」会同时让 CMD、PowerShell 和第三方软件识别 git,这是绝大多数教程和我们的推荐;第三项用于只想要纯 Bash 环境的特殊场景,普通用户不需要。装完如果发现 CMD 里 git 用不了,多半是当时选了第一项,重新运行安装包改这一项即可,不用卸载重装。

向导里的另外两个建议项

第二处值得停一下的是默认编辑器(Choosing the default editor):默认是 Vim,新手打开后不知道怎么退出是常见劝退点;装了 VS Code 就下拉选「Use Visual Studio Code as Git's default editor」,没装图形编辑器就保持默认的 Notepad(记事本)也行,写提交信息够用。第三处是初始分支名(Adjusting the name of the initial branch):git init 默认创建的分支叫 master,国际社区通用的默认名已改成 main;想保持一致可以勾选「Override the default branch name for new repositories」填 main,不勾也不影响使用,之后随时用 git branch -m main 改名。其余选项——组件、开始菜单、SSH(保持 Use bundled OpenSSH)、HTTPS 传输库、行尾转换(保持默认的 Windows 检出、Unix 提交)、终端模拟器、凭证管理器——全部保持默认即可,这些默认值就是为绝大多数 Windows 用户准备的。

装完先做两件事

安装完成后打开一个新的命令行窗口(旧窗口读不到新加的 PATH),输入 git --version,能输出版本号就说明安装成功。第二件事是配置提交身份:输入 git config --global user.name "你的名字" 和 git config --global user.email "你的邮箱" 两句话,缺了它们第一次 commit 会直接报错提示配置身份,这是 Git 官方设定,不是装坏了。名字和邮箱写入的是你本地的提交记录里,不想公开展示真实信息可以用网名,但格式必须是「名字 + 邮箱」两项齐全。

常见翻车点与排查

装完最常见的问题是 CMD 里提示「'git' 不是内部或外部命令」,原因就两种:PATH 选项选了第一项,或者装完后还开着旧窗口。先新开一个窗口再试,仍然不行就重跑安装包改 PATH 选项。第二个常见问题是教程要求 main 分支名但演示的是 master,按上文改初始分支名或在仓库里执行 git branch -m main 即可。第三个要提醒的是搜索「Git 中文客户端」「GitHub 下载器」得到的结果基本是第三方打包或另一款图形工具,不是 Git 本体,Git 本体只有官方域名那一个安装包。

行尾转换与凭证管理默认值再解释

安装向导里还有两步会被反复问到,一句话说清。第一步是行尾转换(Configuring the line ending conversions),默认选「Windows 检出、Unix 提交」,含义是:git 检出代码到你本地磁盘时转成 Windows 的 CRLF 行尾,提交回仓库时还原成 Unix 的 LF,这样同一份代码在 Windows 和服务器上都能正常显示与运行,除非你的团队有统一约定,否则保持默认不动即可。第二步是凭证管理(Git Credential Manager),默认启用,作用是记住你第一次输入的 GitHub、GitLab 账号密码或访问令牌,之后推送拉取不必反复输入;它是微软维护的官方组件,随 Git for Windows 一起分发,保持默认就是最佳选择。这两个选项在向导里都排在 PATH 之后的页面,普通用户完全不用修改,直接 Next 即可。

装完 Git 做这几件确认

1. 新开命令行窗口,输入 git --version,能输出版本号。2. 执行 git config --global user.name "你的名字" 和 user.email 两句配置,避免首次提交报错。3. 在 VS Code 里打开终端(Ctrl+)再输一次 git,确认 IDE 里也能识别。4. 教程要求特定版本时,到官方发布页按版本号选文件,别用非官方镜像站的旧包。5.` 需要随身携带时才用便携版,日常开发一律装官方安装版,方便自动更新。