跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
Python

Windows Git 安装与配置全流程指南

综述由AI生成Windows 环境下 Git 安装涉及多个配置选项,直接影响后续开发体验。详细解析了从下载安装到环境配置的完整流程,重点说明了编辑器选择、分支命名、环境变量及换行符处理等关键节点。通过避开 Vim 陷阱、统一 main 分支、启用 OpenSSL 库及开启文件系统缓存,可确保 Git 在 Windows 上稳定高效运行,为 Python 或其他语言开发打下坚实基础。

remedios发布于 2026/3/21更新于 2026/5/36 浏览
Windows Git 安装与配置全流程指南

Git 是开发者的必备工具。对于 Windows 用户而言,安装向导中的几十个选项往往让人眼花缭乱。本文旨在梳理关键配置项,确保你的环境既符合现代标准,又能避免后续踩坑。

一、下载安装包

1. 获取途径
  • 官方渠道:访问 git-scm.com/download/win

文章配图

  • 下载方式:直接点击页面上的 "Click here to download" 或 "Git for Windows/x64 Setup" 获取 .exe 安装包。虽然支持 Winget 命令行下载,但对于初次配置环境的用户,传统安装包更稳妥。
2. 版本选择
  • x64 版本:绝大多数 Intel 或 AMD 芯片的电脑请下载此版本。
  • ARM64 版本:仅适用于高通骁龙芯片的轻薄本或 Mac 虚拟机。若不确定系统类型,可通过 Win 键搜索'关于你的电脑'查看。

文章配图

二、安装向导详解

双击安装包后,大部分步骤可直接点击 "Next",但以下环节建议按推荐配置调整,否则后续使用会非常不便。

1. 安装路径

默认路径为 C:\Program Files\Git。除非 C 盘空间严重不足,否则建议保持默认。

  • 兼容性:PyCharm、VS Code 等主流 IDE 通常会自动识别该默认路径下的 Git。若修改路径,可能需要在 IDE 中手动重新配置。
  • 权限管理:默认路径下 Windows 权限控制最规范,能减少'拒绝访问'类错误。

文章配图

2. 组件选择 (Select Components)

这是最核心的配置界面,请重点关注以下几项:

⬜✅ Additional icons (附加图标)
  • On the Desktop (在桌面上):默认不勾选。桌面图标越少越清爽,通常我们直接在项目文件夹右键打开 Git Bash,或在编辑器内调用。
✅ Windows Explorer integration (资源管理器集成) —— ⭐ 必选

将 Git 功能添加到鼠标右键菜单。

  • Open Git Bash here:必选。进入项目文件夹右键点击即可打开命令行并自动定位到当前目录,省去手动输入 cd 路径的痛苦。
  • Open Git GUI here:保留默认。图形化界面适合快速查看提交历史。
✅ Git LFS (Large File Support)
  • 解读:Git 原生擅长存储文本代码,处理大图片、视频效率低。LFS 是专门用于管理大文件的扩展插件,许多开源项目依赖它,建议勾选。
✅ Associate .git configuration files with default text editor
  • 解读:将 .gitconfig 等配置文件关联到默认文本编辑器。勾选后双击文件即可直接编辑,无需系统询问用何软件打开。
✅ Associate .sh files to be run with Bash
  • 解读:关联 Linux 脚本文件。勾选后在 Windows 上双击 .sh 文件可自动通过 Bash 运行,便于跨平台脚本执行。
⬜ Check daily for Git for Windows update
  • 解读:不要勾选。Git 本身非常稳定,不需要每日检查更新。手动更新即可,避免弹窗打扰。
⬜ Add a Git Bash Profile to Windows Terminal
  • 解读:看个人喜好。如果你使用的是 Win11 或安装了微软的 Windows Terminal,勾选后可在终端下拉菜单中看到 Git Bash;否则保持默认。
✅ Scalar
  • 解读:微软开发的用于管理超大规模仓库的插件。个人项目虽用不上,但占用资源极少,保留作为未来扩展即可。

文章配图

3. 开始菜单设置
  • Start Menu Folder:保持默认的 "Git"。改名可能导致日后找不到入口。
  • Don't create a Start Menu folder:不要勾选。保留开始菜单入口方便随时调用。

文章配图

4. 默认编辑器 (Choosing the Editor) —— ⭐ 避坑重点

这一步决定 Git 需要输入提交信息时调用的软件。

  • 默认选项 Vim:纯命令行古老编辑器,无鼠标操作,保存退出需记命令 (:wq)。新手极易卡死在这里。
  • 推荐操作:务必在下拉菜单中选择其他选项。
    • 首选:Use Visual Studio Code as Git's default editor(若已安装 VS Code)。
    • 保底:Use Notepad as Git's default editor(记事本)。虽简陋但绝对安全,不会卡住。

文章配图

5. 分支命名 (Branch Name)
  • Let Git decide:默认主分支名为 master。这是旧标准。
  • Override the default branch name:推荐选择。将默认分支名改为 main。
  • 理由:GitHub、GitLab 等平台现在新建项目默认均为 main。本地统一设为 main 可避免推送时出现 master 与 main 双分支混乱的情况。

文章配图

6. 环境变量 (PATH Environment)

决定在哪些地方可以输入 git 命令。

  • Use Git from Git Bash only:太保守。仅在 Git Bash 可用,CMD 或 IDE 终端无法调用。
  • Git from the command line and also from 3rd-party software:推荐选中。可在 CMD、PowerShell、IDE 终端中使用 Git,且不干扰系统自带命令。
  • Use Git and optional Unix tools from the Command Prompt:千万别选。这会覆盖 Windows 自带的 find、sort 等命令,导致系统异常。

文章配图

7. SSH 工具
  • Use bundled OpenSSH:推荐。使用 Git 安装包自带的版本,开箱即用,稳定性高。
  • Use external OpenSSH:高级选项。仅当你已在系统中手动配置好 OpenSSH 并希望共用密钥时才选。

文章配图

8. HTTPS 传输后端
  • Use OpenSSL library:推荐。Git 自带证书库,独立于 Windows 系统,不受公司策略或系统更新影响,连接更稳定。
  • Use native Windows Secure Channel library:适用于大型公司环境,需使用内部根证书时选择。

文章配图

9. 换行符转换 (Line Ending Conversion)

解决 Windows (CRLF) 与 Linux/macOS (LF) 的差异。

  • Checkout Windows-style, commit Unix-style:推荐。检出时自动转为 Windows 格式防乱码,提交时自动转回 Unix 格式保仓库整洁。Windows 用户必选。
  • Checkout as-is, commit Unix-style:检出不转换,可能导致老软件显示异常。
  • Checkout as-is, commit as-is:完全不处理,易造成协作灾难。

文章配图

10. 终端模拟器
  • Use MinTTY:推荐。类 Linux 风格窗口,支持自由缩放、文字复制粘贴,体验远优于 Windows 默认控制台。
  • Use Windows' default console window:老式黑底白字窗口,操作受限,不建议选择。

文章配图

11. 拉取行为 (Pull Behavior)
  • Fast-forward or merge:推荐。Git 经典模式。无冲突时快进,有冲突时创建合并提交,最安全直观。
  • Rebase:高级技巧,会修改提交历史,新手慎用。
  • Only ever fast-forward:严格模式,有分叉即报错,不适合日常开发。

文章配图

12. 凭据助手 (Credential Helper)
  • Git Credential Manager:强烈推荐。首次登录 GitHub/GitLab 后,它会加密保存凭证。后续 git push 时无需重复输入密码。
  • None:每次推送都要求输入账号密码,体验极差。

文章配图

13. 性能优化
  • Enable file system caching:必须勾选。利用内存缓存文件系统数据,显著提升 Git 在 Windows NTFS 上的性能,避免 git status 卡顿。
  • Enable symbolic links:默认不勾。符号链接在 Windows 上权限复杂,除非明确需要跨平台链接支持,否则保持默认。

文章配图

三、验证与初始化

安装完成后,打开 CMD 或 PowerShell 验证版本:

git --version

若显示类似 git version 2.x.x.windows.1 的版本号,说明安装成功。

文章配图

四、配置身份

很多新手直接克隆代码却报错,是因为还没告诉 Git '你是谁'。请在命令行依次输入以下两行(替换为你的真实信息):

git config --global user.name "你的英文昵称"
git config --global user.email "你的邮箱@example.com"

配置完成,现在可以愉快地开始版本控制了。


配置速查清单

除了上述细节,以下 4 点最为关键,请务必确认:

  1. 编辑器:别用 Vim,选 VS Code 或 Notepad。
  2. 分支名:默认改为 main,与 GitHub 保持一致。
  3. 环境变量:选第二个选项,确保 IDE 和 CMD 都能用 git。
  4. HTTPS 后端:选 OpenSSL,比 Windows 原生通道更稳。

其余选项按推荐勾选,一路 Next 即可完成。

目录

  1. 一、下载安装包
  2. 1. 获取途径
  3. 2. 版本选择
  4. 二、安装向导详解
  5. 1. 安装路径
  6. 2. 组件选择 (Select Components)
  7. ⬜✅ Additional icons (附加图标)
  8. ✅ Windows Explorer integration (资源管理器集成) —— ⭐ 必选
  9. ✅ Git LFS (Large File Support)
  10. ✅ Associate .git configuration files with default text editor
  11. ✅ Associate .sh files to be run with Bash
  12. ⬜ Check daily for Git for Windows update
  13. ⬜ Add a Git Bash Profile to Windows Terminal
  14. ✅ Scalar
  15. 3. 开始菜单设置
  16. 4. 默认编辑器 (Choosing the Editor) —— ⭐ 避坑重点
  17. 5. 分支命名 (Branch Name)
  18. 6. 环境变量 (PATH Environment)
  19. 7. SSH 工具
  20. 8. HTTPS 传输后端
  21. 9. 换行符转换 (Line Ending Conversion)
  22. 10. 终端模拟器
  23. 11. 拉取行为 (Pull Behavior)
  24. 12. 凭据助手 (Credential Helper)
  25. 13. 性能优化
  26. 三、验证与初始化
  27. 四、配置身份
  28. 配置速查清单
  • 💰 8折买阿里云服务器限时8折了解详情
  • GPT-5.5 超高智商模型1元抵1刀ChatGPT中转购买
  • 代充Chatgpt Plus/pro 帐号了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Linux 定时更新 Git 仓库脚本方案
  • AIGC 时代下 R 语言在数据科学中的应用实践
  • FPGA 中快速傅里叶变换(FFT)的实现与配置
  • FileSaver.js 前端文件下载实战解析
  • Spring Cloud 环境和工程基本搭建
  • 动态规划:子数组与子串问题
  • 大语言模型应用指南:Gorilla
  • Docker 本地部署 Dify 教程
  • Apache Tomcat曝三大安全漏洞,最严重可致远程代码执行(CVE-2025-55752)
  • IO 多路复用 select 接口解析与服务器实战
  • 2026 年前端发展趋势:AI 原生与全栈化演进
  • ClawdBot 本地化语音翻译工作流:Whisper 转写与多语言支持
  • 2024 年大模型行业研究报告
  • DeepSeek 中冷启动数据与多阶段训练的作用
  • TCP 协议详解:报文结构、连接管理与流量控制
  • Python 核心应用场景:Web 开发、数据科学与自动化实战
  • Web 开发中五种常用加密算法实战及原理详解
  • OpenClaw 部署与 QQ 机器人接入指南
  • Linux 下集成 OpenClaw 至 QQ 机器人
  • GitHub 高效挖掘优质开源项目的四种实战路径

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • 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