跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言

Windows Git 安装与配置详解 (2025 版)

Windows 环境下 Git 安装配置详解。涵盖安装包下载、组件选择、编辑器设置、分支命名规范、环境变量配置及终端选项优化。重点推荐将默认编辑器改为 VS Code 或记事本,避免 Vim 操作困难;主分支名建议设为 main 以符合主流标准;开启文件系统缓存提升性能。验证安装后需配置全局用户名和邮箱,确保代码提交记录准确无误。

Pythonist发布于 2026/3/28更新于 2026/6/1116 浏览
Windows Git 安装与配置详解 (2025 版)

Git 是版本控制的核心工具,但在 Windows 环境下,安装过程中的选项往往让人困惑。本指南将带你完成从零到可用的完整配置,确保环境符合现代开发标准。

下载安装包

1. 下载地址

  • 官方网站:git-scm.com/download/win

下载页面

  • 下载方式:直接点击页面上的 "Click here to download" 或 "Git for Windows/x64 Setup" 获取 .exe 安装包。
    • *注:虽然支持 Winget 命令行下载,但对于初次配置,传统安装包更稳妥。

2. 版本选择

  • 绝大多数电脑(Intel/AMD):请下载 x64 版本。
  • 少数轻薄本(高通骁龙)或 Mac 虚拟机:请下载 ARM64 版本。
    • 不确定?按 Win 键搜索'关于你的电脑',查看'系统类型'。

系统类型


逐步安装配置

1. 初始界面

安装向导启动

2. 安装路径

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

安装路径

理由:

  1. 兼容性:PyCharm、VS Code 等工具通常默认查找此路径,修改后可能需手动配置。
  2. 权限管理:默认路径下 Windows 权限规范,能减少'拒绝访问'错误。

3. 组件选择

这是最关键的环节,直接影响后续使用体验。

组件选择

附加图标 (Additional icons)
  • On the Desktop:桌面快捷方式。不推荐勾选,项目文件夹右键菜单更方便。
Windows Explorer integration (资源管理器集成) ⭐ 核心
  • Open Git Bash here:必选。在文件夹右键即可打开命令行并自动定位,省去输入长路径的麻烦。
  • Open Git GUI here:保留默认。图形界面查看历史有时更直观。
Git LFS (Large File Support)
  • 必选。用于高效管理大文件(图片、视频),防止仓库膨胀。
关联配置文件 (.gitconfig)
  • 必选。双击 .gitconfig 文件时直接用编辑器打开,方便修改。
关联 .sh 文件
  • 必选。允许在 Windows 上运行 Linux 脚本。
每日检查更新
  • 不要勾选。Git 稳定,无需频繁弹窗检查。
Windows Terminal 配置
  • 看个人喜好。若使用 Win11 自带终端或安装了 Windows Terminal,可勾选以便调用。
Scalar
  • 保留默认。微软开发的超大型仓库管理插件,普通项目无感占用,留着备用即可。

4. 开始菜单文件夹

直接点击 Next,保持默认的 "Git" 文件夹名,便于日后查找。

开始菜单

5. 默认编辑器 ⚠️ 避坑重点

这一步决定了提交代码时用什么软件写备注。

编辑器选择

  • 默认 Vim:纯命令行古老编辑器,无鼠标操作,保存退出复杂 (:wq)。新手极易卡死。
  • 推荐 Visual Studio Code:如果已安装,首选它,界面熟悉。
  • 保底 Notepad:没装 VS Code 就选记事本,简单可靠。

操作:务必下拉菜单切换,不要直接点 Next!

编辑器效果

6. 分支命名

  • Let Git decide:默认 master,旧标准。
  • Override...:推荐选择,填入 main。

为什么改? GitHub、GitLab 等主流平台现在默认主分支都是 main。本地设为 main 能避免推送时出现分支混乱。

分支命名

7. 环境变量 PATH

决定在哪里能输入 git 命令。

环境变量

  • Use Git from Git Bash only:太局限,IDE 终端无法用。
  • Git from command line and also from 3rd-party software:推荐。CMD、PowerShell、PyCharm 都能用,且不干扰系统命令。
  • Use Git and optional Unix tools...:警告会覆盖 Windows 自带工具,别选。

8. SSH 工具

  • Use bundled OpenSSH:推荐。Git 自带,开箱即用,最稳定。
  • Use external OpenSSH:高级用户专用,需自行配置系统 SSH。

9. 安全验证

  • Use OpenSSL library:推荐。独立证书库,不受 Windows 系统设置影响,个人开发者最稳。
  • Use native Windows Secure Channel:适用于公司内网强制证书环境。

10. 换行转换

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

换行符

  • Checkout Windows-style, commit Unix-style:推荐。下载时转成 Windows 格式防乱码,上传时转回 Unix 格式保统一。跨平台协作必备。

11. 终端窗口

  • Use MinTTY:推荐。类 Linux 风格,支持缩放、复制粘贴友好,界面现代。
  • Use Windows' default console:老式 CMD 黑框,操作反人类,除非特殊需求别选。

12. 拉取方式

  • Fast-forward or merge:推荐。经典模式,自动处理快进或合并,最安全。
  • Rebase:高级技巧,修改提交历史,新手慎用。

13. 记住密码

  • Git Credential Manager:强烈推荐。首次登录网页授权后,后续 push/pull 自动认证,无需重复输密码。
  • None:每次都要输密码,极度折磨。

14. 性能配置

  • Enable file system caching:必须勾选。提升 Git 在 Windows 上的读取速度,否则大项目操作会卡顿。
  • Enable symbolic links:默认不勾。涉及符号链接权限问题,普通项目不需要。

关键节点速查

除了上述细节,以下 4 处最容易踩坑,请重点确认:

  1. 编辑器:避开 Vim,改用 VS Code 或 Notepad。
  2. 分支名:改为 main 以匹配主流平台。
  3. PATH:选第二个选项,确保 IDE 终端可用。
  4. HTTPS 后端:选 OpenSSL 库,稳定性更好。

其余步骤一路 Next 即可。

验证与初始化

安装完成后,打开 CMD 输入:

git --version

显示版本号即表示成功。

验证结果

配置身份

Git 需要知道'你是谁'才能记录提交信息。依次执行:

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

配置完毕,即可开始版本控制之旅。

目录

  1. 下载安装包
  2. 1. 下载地址
  3. 2. 版本选择
  4. 逐步安装配置
  5. 1. 初始界面
  6. 2. 安装路径
  7. 3. 组件选择
  8. 附加图标 (Additional icons)
  9. Windows Explorer integration (资源管理器集成) ⭐ 核心
  10. Git LFS (Large File Support)
  11. 关联配置文件 (.gitconfig)
  12. 关联 .sh 文件
  13. 每日检查更新
  14. Windows Terminal 配置
  15. Scalar
  16. 4. 开始菜单文件夹
  17. 5. 默认编辑器 ⚠️ 避坑重点
  18. 6. 分支命名
  19. 7. 环境变量 PATH
  20. 8. SSH 工具
  21. 9. 安全验证
  22. 10. 换行转换
  23. 11. 终端窗口
  24. 12. 拉取方式
  25. 13. 记住密码
  26. 14. 性能配置
  27. 关键节点速查
  28. 验证与初始化
  29. 配置身份
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • CC-Switch:AI 编码助手配置管理工具
  • 宇树科技机器人核心技术
  • OpenClaw Webhook 配置与集成指南
  • Foxglove 开发环境完整搭建指南 (含常见坑位)
  • Copilot Cowork 核心逻辑解析:使用 Kotlin 构建 AI Agent
  • 利用豆包降低论文 AIGC 检测率的实战经验与指令模板
  • 密码攻击实践:传递 Net-NTLMv2 哈希
  • GitHub MCP 服务配置与调用实战指南
  • FPGA 入门:基于 LED 的 2 选 1 多路选择器设计
  • C++ 异常处理机制详解与避坑指南
  • OpenClaw 开源 AI 智能体项目精选与部署指南
  • Web3.0 开发实践:核心概念与技术演进
  • Spring Boot 消息队列与异步通信详解
  • 基于 SpringBoot2 与 Vue3 的新能源充电管理系统设计与实现
  • Python 环境变量配置与验证指南
  • C++11 新特性:可变参数模板、类功能、STL 变化与包装器
  • 医疗连续体机器人模块化控制界面设计与 Python 库应用
  • RHEL 8 通过 yum 快速部署 OpenJDK 17 开发环境
  • 二叉树算法实战:美国血统与公共祖先求解
  • AI 时代产品经理的能力边界:AI 能做什么与不能做什么

相关免费在线工具

  • 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