跳到主要内容 Windows Git 安装全流程与配置指南 | 极客日志
Shell / Bash
Windows Git 安装全流程与配置指南 Windows Git 安装流程涵盖下载安装包、组件选择、环境变量配置及终端设置等关键步骤。推荐选择 x64 版本，默认安装路径，启用资源管理器集成与 Git LFS。编辑器建议设为 VS Code 或记事本避免 Vim 操作困难。分支命名推荐使用 main 以符合主流标准。环境变量选择命令行及第三方软件可用模式，SSH 使用内置 OpenSSH，换行符自动转换防止跨平台乱码。终端选用 MinTTY，拉取策略选快进或合并，凭据管理器开启以保存密码。最后验证版本并配置用户信息完成环境搭建。
Git 是程序员的必备工具。对于 Windows 用户来说，安装过程中的选项往往让人困惑。本教程将详细介绍安装流程及关键配置，确保环境符合现代开发标准。
第一步：下载安装包
1. 下载地址
下载方式 ：推荐直接点击页面上的 "Click here to download" 或 "Git for Windows/x64 Setup" 下载独立的 .exe 安装程序。
*注：虽然可以用 Winget 命令行下载，但传统安装包更适合初次配置。
2. 版本选择 (x64 vs ARM64)
绝大多数电脑（Intel/AMD 芯片） ：请下载 x64 版本。少数轻薄本（高通骁龙芯片）或 Mac 虚拟机 ：请下载 ARM64 版本。
*如果不确定，按 Win 键搜索'关于你的电脑'，查看'系统类型'。
第二步：逐步安装
1. 初始界面
2. 安装路径 建议保持默认 (直接点 Next)，除非 C 盘空间完全不够。否则建议保持默认直接点击「Next」：
省事：PyCharm、VS Code 等开发工具通常会自动去 C:\Program Files\Git 这个默认位置找 Git。如果改到了 D 盘或其他文件夹，以后可能还得在 IDE 里手动设置一遍 Git 的路径。
避免权限问题：放在默认路径下，Windows 的权限管理最规范，能避免很多莫名其妙的'拒绝访问'错误。
3. 选择组件
3.1 ⬜✅ Additional icons (附加图标)
On the Desktop (在桌面上)
含义：在电脑桌面上创建一个 Git Bash 的快捷方式图标
解读 ：默认不勾选，看个人喜好。一般很少专门双击图标打开 Git，通常在项目文件夹右键打开或在编辑器中使用。
3.2 ✅ Windows Explorer integration (Windows 资源管理器集成) —— ⭐ 最核心功能 这是一个'大标题'，下面包含两个子选项。它的意思是：把 Git 的功能添加到鼠标右键菜单里。
✅ Open Git Bash here (在这里打开 Git Bash)
含义 ：当进入某个文件夹（比如 Python 项目文件夹），点击鼠标右键，菜单里会出现这个选项。点击它，黑色的命令行窗口就会弹出来，并且自动定位到当前文件夹。解读 ：必选！ 这是 Git 在 Windows 上最高频的操作入口。没有它，每次打开命令行都得手动输入 cd D:\我的项目\代码 这样长长的路径。
✅ Open Git GUI here (在这里打开 Git GUI)
含义 ：在右键菜单里添加'打开 Git 图形界面'的选项解读 ：保留默认 。虽然程序员多用命令行，但有时候用图形界面看看代码修改历史也挺直观的。
3.3 ✅ Git LFS (Large File Support) (Git 大文件支持)
含义 ：LFS (Large File Storage) 是 Git 的一个扩展插件解读 ：必选
Git 原本设计是用来存代码（纯文本）的，存大图片、视频、音频效率极低，甚至会把仓库撑爆。
LFS 就是专门帮 Git '开外挂'来高效管理这些大文件的。很多开源项目都依赖它。
3.4 ✅ Associate .git configuration files with the default text editor *
翻译 ：将 .gitconfig 配置文件关联到默认文本编辑器解读 ：必选
Git 的配置文件通常叫 .gitconfig。勾选这个后，在电脑里看到这种文件，双击它，它就会直接用设置好的编辑器（比如记事本）打开，方便修改配置。
3.5 ✅ Associate .sh files to be run with Bash
翻译 ：关联 .sh 文件，使其通过 Bash 运行解读 ：必选
.sh 文件是 Linux 系统的脚本（类似于 Windows 的 .bat）。因为装了 Git Bash（它模拟了 Linux 环境），勾选这个后，在 Windows 上双击 .sh 文件，它就能自动跑起来。
3.6 ⬜ Check daily for Git for Windows update
翻译 ：每天检查 Git for Windows 的更新解读 ：不要勾选
Git 是一个非常成熟稳定的工具，不需要像手机 App 那样天天更新。勾选这个后，它每天都会联网检查，如果有新版本就会弹窗骚扰。
3.7 ⬜✅ Add a Git Bash Profile to Windows Terminal
翻译 ：将 Git Bash 的配置文件添加到 Windows Terminal 中解读 ：看个人喜好（默认不勾）
如果用的是 Win11，或者自己安装了微软的 Windows Terminal ，勾选这个会让 Git Bash 自动出现在它的下拉菜单里。如果不知道 Windows Terminal 是什么，那就别勾。
3.8 ✅ Scalar (Git add-on to manage large-scale repositories)
翻译 ：Scalar（用于管理超大规模仓库的 Git 插件）解读 ：保留默认
这是微软为了管理像 Windows 源代码那种巨型 仓库开发的技术。个人的 Python 项目可能只有几兆大小，完全用不上它，但装了它也不会占什么资源。
4. 开始按钮 这一步非常简单，不需要任何修改。直接点击「Next」即可。
4.1 标题与问题
Select Start Menu Folder
翻译 ：选择开始菜单文件夹。含义 ：当在键盘上按 Win 键弹出菜单时，你希望 Git 的图标出现在哪个文件夹里？
4.2 输入框 (Git)
当前内容 ：Git解读 ：这是默认的名字。安装完成后，开始菜单里就会多出一个叫 "Git" 的文件夹。建议千万别改，保持默认的 "Git" 是最清晰的。
4.3 下方的勾选框
Don't create a Start Menu folder
翻译 ：不要创建开始菜单文件夹解读 ：如果勾选了这个，Git 就不会在开始菜单里创建任何快捷方式。建议不要勾选，留个入口总是好的。
5. 选编辑器
5.1 解读（为什么这一步是个'坑'？） 这一步是在问：'当 Git 需要写字（比如写代码提交的备注信息）时，要自动打开哪个软件？'
目前的默认选项 (Vim) ：
这是一个纯命令行的古老编辑器。
它没有鼠标操作 ，不能直接打字，很难保存退出。后果 ：如果不小心保留了这个选项，以后每一次提交代码，屏幕就会突然变黑进入 Vim，如果不知道怎么操作，就会卡死在那里。
5.2 必须做的操作 千万不要直接点 Next！建议点击那个下拉菜单，换掉 Vim！
根据自身情况，推荐两种选择：
首选 ：Use Visual Studio Code as Git's default editor
如果电脑里装了 VS Code，选这个最舒服。它会弹出一个熟悉的窗口。
保底 ：Use Notepad as Git's default editor
如果没装 VS Code，就选最下面的 Notepad（记事本）。这是 Windows 自带的，虽简陋但绝对不会让你卡住。
5.3 选 Notepad (记事本) 或 VS Code 后
Git 会弹出一个熟悉的、白底黑字的窗口。
可以像写 Word 文档一样打字。
写完点右上角的 X 关闭，或者点'保存'。
结果 ：Git 接收到文字，顺利完成提交。
6. 分支命名
6.1 选项 1：Let Git decide (让 Git 决定)
说明 ：Let Git use its default branch name (currently: "master")...翻译 ：使用 Git 传统的默认名 —— master解读 ：这是过去十几年来的老标准。
6.2 选项 2：Override the default branch name for new repositories (覆盖默认分支名) —— 🌟 推荐选择
说明 ：Many teams already renamed their default branches...翻译 ：许多团队已经更改了默认分支名，常见的选择是 main...解读 ：这是目前的国际新标准 。
6.3 为什么要改选第二个 (main)？
主流趋势 ：GitHub、GitLab 等主流代码托管平台，现在创建新项目时，默认主分支都叫 main避免混乱 ：如果在本地选了默认的 master，而在 GitHub 上建的仓库叫 main，当推送代码时，就会发现有两个主分支，管理起来非常麻烦。统一标准 ：直接在安装时设为 main，能让本地和远程仓库保持一致，省去以后改名的麻烦。
7. 配置路径 这一步是在设置 PATH 环境变量 。简单来说，它决定了可以在电脑的哪些地方输入 git 命令来使用它 。
✅ 建议：保持默认 (选中间的)，直接点击「Next」即可。这是最推荐、最稳妥的选项
7.1 选项 1：Use Git from Git Bash only (仅在 Git Bash 中使用 Git)
翻译 ：这是最保守的选择。只能在 Git Bash 这个软件里用 Git，在别的地方（比如 CMD 或 PyCharm）里敲 git 命令，电脑会说'找不到命令'解读 ：太不方便了，不要选 。这意味着在写 Python 代码时，不能直接在 IDE 的终端里提交代码。
7.2 选项 2：Git from the command line and also from 3rd-party software (从命令行和第三方软件使用 Git) —— 🌟 推荐选中
说明 ：(Recommended) This option adds only some minimal Git wrappers...翻译 ：(推荐) 此选项只添加最基本的 Git 包装器到环境变量中……可以在 Git Bash、CMD、PowerShell 以及 Python/VS Code 等第三方软件中正常使用 Git。解读 ：这是最佳选择 。
它让你在任何地方（包括 PyCharm 终端等）都能用 git 命令。
同时，它不会 干扰 Windows 系统自带的命令。
7.3 选项 3：Use Git and optional Unix tools from the Command Prompt (在命令提示符中使用 Git 和可选的 Unix 工具)
警告 ：Warning: This will override Windows tools like "find" and "sort"翻译 ：警告 ：这将覆盖 Windows 自带的工具，如 "find" 和 "sort"解读 ：千万别选这个 （除非你是 Linux 专家）。
8. SSH 工具
8.1 选项 1：Use bundled OpenSSH
翻译 ：使用 Git 自带的 OpenSSH 解释 ：This uses ssh.exe that comes with Git.（这会使用 Git 安装包里自带的 ssh.exe 程序。）✅ 建议 ：绝大多数用户（包括初学者和开发者）都建议选这个
因为它使用的是 Git 安装包里经过测试的版本，开箱即用。
它不会受到电脑环境变量配置的影响，最稳定，不容易出 bug。
8.2. 选项 2：Use external OpenSSH
翻译 ：使用外部的 OpenSSH 解释 ：This uses an external ssh.exe...（这会使用外部的 ssh.exe。Git 不会安装它自带的 OpenSSH，而是去系统环境变量 PATH 里找现有的）适用场景 ：这是给高级用户准备的。如果已经在 Windows 10/11 中手动配置了系统的 OpenSSH，并且希望 Git 共用电脑里那套现成的 SSH 密钥和配置文件，才选这个。
9. 安全验证
9.1 选项 1：Use the OpenSSL library (使用 OpenSSL 库) —— 🌟 推荐选择
说明 ：Server certificates will be validated using the ca-bundle.crt file翻译 ：服务器证书将使用自带的 ca-bundle.crt 文件进行验证解读 ：
Git 自带 了一套安全证书（就像自带了一本「好人名单」）。
优点 ：它完全独立，不受 Windows 系统设置的影响。不管 Windows 系统证书有没有乱七八糟的问题，Git 都能稳定工作。对于个人开发者，这是最稳妥 的选择。
9.2 选项 2：Use the native Windows Secure Channel library (使用原生 Windows 安通道库)
说明 ：Server certificates will be validated using Windows Certificate Stores...翻译 ：服务器证书将使用 Windows 系统证书存储进行验证。此选项允许使用公司内部分发的根证书……解读 ：
Git 会去问 Windows 系统：'这个网站安全吗？'
适用场景 ：这通常用于大型公司环境 。如果在公司上班，且公司电脑强制安装了内部监控证书（用于访问内网），那就必须选这个，否则 Git 会报错。对于个人用户，没必要选。
10. 换行转换 这一步是在设置换行符自动转换 。因为 Windows 和 Linux/macOS 系统对'换行'（也就是回车键）的定义是不一样的。
10.1 选项 1：Checkout Windows-style, commit Unix-style line endings (检出时用 Windows 风格，提交时用 Unix 风格) —— 🌟 推荐选择
原理 ：
下载代码时 (Checkout) ：Git 会把仓库里的标准格式 (LF) 自动转换成 Windows 习惯的格式 (CRLF)，这样记事本打开才不会乱码。上传代码时 (Commit) ：Git 会把电脑上的 Windows 格式 (CRLF) 自动变回标准格式 (LF)，保证仓库里的代码干净、统一。
解读 ：这是一个自动翻译机 。它能防止因为用了 Windows，结果把整个团队的代码格式都搞乱了。Windows 用户必选此项。
10.2 选项 2：Checkout as-is, commit Unix-style line endings (检出不转，提交转 Unix)
解读 ：通常是 Unix/Linux 用户选的。Windows 用户选这个可能会导致某些老软件打开文件显示成一行。
10.3 选项 3：Checkout as-is, commit as-is (都不转)
解读 ：完全不处理。除非完全不和别人合作，或者明确知道自己在干什么，否则千万别选，容易造成跨平台协作灾难。
11. 终端窗口
11.1 选项 1：Use MinTTY (the default terminal of MSYS2) —— 🌟 推荐选择
翻译 ：使用 MinTTY（MSYS2 的默认终端）。解读 ：
这是一个类 Linux 风格 的窗口。
优点 ：界面更好看，支持自由缩放窗口大小，支持像 Word 一样随意的文字选择和复制，字体和配色也更现代。绝大多数开发者都用这个 。注意 ：它提到交互式 Python 需要 winpty，但现在的版本通常兼容性已经很好了，不用太担心。
11.2 选项 2：Use Windows' default console window (使用 Windows 默认控制台窗口)
翻译 ：使用 Windows 的默认控制台窗口 (cmd.exe)解读 ：
这就是那个老式的、黑底白字的 Windows CMD 窗口。
缺点 ：滚动查看历史记录很受限，复制粘贴操作很反人类（矩形选择），而且字体支持也不如 MinTTY 好。除非有极特殊的怀旧情结或兼容性需求，否则别选这个 。
12. 拉取方式 这一步是在设置 git pull（拉取代码）的默认行为当别人的代码更新了，你把新代码拉取到本地时，Git 应该怎么把两份代码合在一起？
12.1 选项 1：Fast-forward or merge (快进或合并) —— 🌟 推荐选择
翻译 ：如果可能，就进行'快进'；否则，创建一个'合并提交'解读 ：这是 Git 的经典标准模式 。
快进 (Fast-forward) ：想象在追剧，落后了 3 集。补看这 3 集（拉取代码），进度条直接走到最新，这叫'快进'。合并 (Merge) ：想象和朋友同时写小说。写了第 3 章，他改了第 1 章。这时候不能直接快进，需要把两人的修改'融合'在一起，这叫'合并'。结论 ：这个选项能自动处理这两种情况，最安全、最符合直觉。
12.2 选项 2：Rebase (变基)
翻译 ：将当前分支变基到拉取的分支之上。解读 ：
这是一种高级技巧，它会修改你的提交历史，让记录看起来像一条直线。
缺点 ：如果有代码冲突，解决起来比上面那种稍微麻烦点，新手容易把代码搞丢或搞乱。
12.3 选项 3：Only ever fast-forward (仅允许快进)
翻译 ：只允许快进。如果不能快进（有分叉），就直接报错失败解读 ：这是最严格的模式，通常是给机器（自动化脚本）用的，人类用起来会很痛苦，动不动就报错。
13. 记住密码 这一步是在设置 凭据管理器 （也就是帮你自动记密码的工具）。简单来说就是：当向 GitHub 推送代码时，Git 该怎么保存账号和密码，从而不用每次都手动输入？
13.1 选项 1：Git Credential Manager (Git 凭据管理器) —— 🌟 强烈推荐选择
翻译 ：使用跨平台的 Git 凭据管理器。解读 ：这是一个'神器'
作用 ：当第一次连接 GitHub/GitLab 时，它会弹出一个网页登录。只要登录这一次，它就会把你的'通行证'加密保存在电脑里 。好处 ：以后每天推送代码（git push）时，它会自动帮你填密码，完全无感，不需要再操心。
13.2 选项 2：None (无)
翻译 ：不使用凭据助手。解读 ：
后果 ：这意味着 Git 会变成'健忘症'。你每一次想上传代码，它都会冷漠地弹窗问你：'你是谁？密码是多少？'体验 ：极其折磨人，除非是为了测试或者有特殊的安全洁癖，否则千万别选。
14. 配置性能
14.1 选项 1：Enable file system caching (启用文件系统缓存) —— 🌟 默认勾选 & 必须保留
翻译 ：批量读取文件系统数据并缓存在内存中……这将提供显著的性能提升。解读 ：
作用 ：给 Git '加速' 。原因 ：Git 在 Linux 上运行得很快，但在 Windows 上，因为文件系统（NTFS）的特性，读取大量小文件会比较慢。后果 ：如果不勾选这个，在操作大项目时（比如运行 git status），电脑可能会卡很久。所以务必勾选 。
14.2 选项 2：Enable symbolic links (启用符号链接) —— ⬜ 默认不勾 & 建议保持
翻译 ：启用符号链接（需要 SeCreateSymbolicLink 权限）。解读 ：
含义 ：符号链接有点像 Windows 的'快捷方式'，但在编程中更高级。坑点 ：在 Windows 上开启这个功能比较麻烦，通常需要管理员权限才能创建链接，而且很多 Windows 软件对它的支持并不完美。建议 ：除非非常确定 Python 项目里用到了跨平台的符号链接，否则不要勾选 ，省得以后报一堆'权限不足'的错误。
关键步骤总结 双击安装包运行，大部分步骤可以直接点 "Next"，但以下 4 个关键节点 请按建议修改，否则后续使用会很麻烦。
关键点 1：选择编辑器 (Choosing the default editor)
默认选项 ：Vim (难度极高，新手噩梦)。✅ 推荐修改为 ：Visual Studio Code (如果装了) 或 Notepad (记事本)。理由 ：Git 需要输入提交信息时会唤起这个软件。Vim 操作反人类，换成记事本或 VS Code 能让你轻松输入文字并保存。
关键点 2：初始分支名 (Adjusting the name of the initial branch)
默认选项 ：Let Git decide (默认叫 master)。✅ 推荐修改为 ：Override the default branch name... 并在框内确认填入 main 。理由 ：GitHub、GitLab 等主流平台现在新建项目默认都叫 main。在本地改好，能避免推送代码时出现'两个主分支'的混乱。
关键点 3：环境变量 PATH (Adjusting your PATH environment)
✅ 推荐选择 ：第二个选项 (Git from the command line and also from 3rd-party software)。理由 ：这样不仅能在 Git Bash 里用 Git，还能在 PowerShell、CMD、PyCharm 自带终端里畅通无阻地使用 Git 命令。避坑 ：千万别选第三个（会覆盖 Windows 自带命令），也别选第一个（只能在 Git Bash 用）。
关键点 4：HTTPS 传输后端 (Choosing HTTPS transport backend)
默认选项 ：Windows Secure Channel。✅ 推荐修改为 ：Use the OpenSSL library (第一个选项)。理由 ：OpenSSL 独立于 Windows 系统证书，更加稳定，不容易因为公司策略或系统更新导致 Git 连不上网。 除了上面 4 点，其余页面一路点击 Next 即可。以下是这些默认选项的含义速览：
Select Components（组件选择） ：默认即可。
进阶建议 ：如果用 Windows Terminal，可以勾选 "Add a Git Bash Profile to Windows Terminal"。
SSH Executable ：选 Use bundled OpenSSH （使用自带的 SSH，最稳）。Line Ending（换行符） ：选 Checkout Windows-style, commit Unix-style （自动处理 Windows/Linux 换行符差异，防乱码必选）。Terminal Emulator ：选 Use MinTTY （更好看的终端窗口）git pull behavior ：选 Fast-forward or merge （最标准的拉取合并模式）Credential Helper ：选 Git Credential Manager （帮记住密码，不用每次推送都输）Extra Options ：勾选 Enable file system caching （开启缓存，提升速度）最后点击 Install ，等待安装完成
第三步：验证安装 安装完成后，需要确认 Git 是否已经准备好工作。
按下 Win + R，输入 cmd 并回车。
如果屏幕显示类似 git version 2.52.0.windows.1 的版本号，安装成功！
初始化配置 安装完后建议先告诉 Git '你是谁' 。请在命令行（CMD 或 PowerShell）中依次输入以下两行代码（把引号里的内容换成你的）：
git config --global user.name "你的英文昵称"
git config --global user.email "你的邮箱@example.com"
相关免费在线工具 Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown转HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
HTML转Markdown 将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
JSON 压缩 通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
JSON美化和格式化 将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online
