> 技术文档 > 手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git


前言:什么是 Git ?

Git 是目前最流行的 分布式版本控制系统(DVCS),最初由 Linus Torvalds(Linux 之父)开发。它可以帮助开发者高效地管理代码版本,跟踪每一次修改,并支持多人协作开发。Git 主要应用于:

  • 代码管理:跟踪代码变化,防止丢失。
  • 协作开发:团队成员可以并行开发,并合并彼此的代码。
  • 分支管理:支持多分支开发,提升开发效率。
  • 版本回溯:随时回滚代码到任何历史版本。
  • 远程仓库同步:通过 GitHub、GitLab 等平台,实现代码托管和共享。

Git 是目前最流行的版本控制工具,在 Windows 上安装 Git 可以通过 官方安装包命令行工具 来完成。本教程将详细介绍如何在 Windows 上安装和配置 Git,并确保你可以顺利使用 Git 进行版本控制。


一、下载安装 Git

1. 下载 Git 安装包

Git 官方提供了 Windows 版本的安装包,你可以从 Git 官方网站下载安装程序:

🔗 Git 官方下载地址:https://git-scm.com/downloads

  1. 进入官网后,点击 Windows 版本的下载按钮。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  2. 点击图中 Click here to download(点击这里下载)。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  3. 下载完成后,你会得到一个类似 Git-2.x.x-64-bit.exe 的安装程序。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

2. 安装 Git

双击下载的 .exe 文件,按照以下步骤进行安装:

  1. 阅读说明,点击Next

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  2. Select Destination Location 页面,你可以选择安装路径(建议保持默认路径 C:\\Program Files\\Git,也可以像我一样更改至E盘),然后点击Next

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  3. 可以选择在桌面添加快捷方式,其它默认直接点击Next

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  4. 选择是否在开始菜单中添加Git选项,可以略过直接点击Next

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  5. Git 选择编辑器,默认为Vim,可以直接略过点击Next

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  6. 配置初始分支名称,Git 默认选项为 Let Git decide,该选项通常会将初始分支名称设置为 master。如果希望使用 main 作为默认分支名称,请选择 Override the default branch name for new repositories(覆盖新仓库的默认分支名称)单选按钮,并在文本框中输入 main。完成配置后,点击Next继续安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

    提示:如对该选项不明确,可保持默认设置,直接点击Next继续安装。

  7. Adjusting your PATH environment(调整 PATH 环境变量)界面,用户需要选择 Git 在命令行中的可用范围。该设置决定了 Git 命令是否可以在 Windows 终端(如 CMD 和 PowerShell)中使用,以及是否影响 Windows 自带的命令。(如对该选项不明确,可保持默认设置,直接点击Next继续安装。)

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

    以下是三个选项的说明:

    1. Use Git from Git Bash only(仅在 Git Bash 中使用 Git)

      • 仅允许在 Git Bash 终端中使用 Git 命令,不会修改系统 PATH 变量。
      • 适用于:希望 Git 仅在 Git Bash 内运行,不影响 Windows 终端的用户。
    2. Git from the command line and also from 3rd-party software(推荐)

      • 允许 Git 命令在 Git Bash、CMD(命令提示符)、PowerShell 以及其他第三方软件中运行。
      • 官方推荐选项,仅添加必要的 Git 组件到系统 PATH,不会覆盖 Windows 自带命令。
      • 适用于:需要在不同终端环境(Git Bash、CMD、PowerShell)中使用 Git 的用户。
    3. Use Git and optional Unix tools from the Command Prompt(使用 Git 及可选的 Unix 工具)

      • 除了 Git 以外,还会将 Git 附带的 Unix 工具(如 findsort)添加到系统 PATH。
      • ⚠ 注意:此选项可能覆盖 Windows 内置工具,如 findsort,可能影响其他命令的正常使用。
      • 适用于:希望在 CMD 和 PowerShell 中使用完整的 Unix 工具集的高级用户。
  8. 选择ssh.exe,默认选项为使用 Git 自带的 ssh.exe。如果已安装并希望使用外部 OpenSSH,可选择 Use external OpenSSH

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

    推荐保持默认,点击Next继续安装。

  9. 选择 HTTP 连接,推荐选择使用 OpenSSL 进行 HTTPS 连接,点击Next继续安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  10. 在配置行结尾转换界面,Git 提供三种换行符处理方式,推荐保持默认,点击Next继续安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

    以下是三种换行符处理方式的说明:

    1. Checkout Windows-style, commit Unix-style line endings(默认选项)

      • 检出文件时,将 LF(Linux/macOS 换行符)转换为 CRLF(Windows 换行符)。
      • 提交文件时,将 CRLF 转换回 LF。
      • 适用于:Windows 用户,确保跨平台兼容性。
    2. Checkout as-is, commit Unix-style line endings

      • 检出时不做转换,提交时将 CRLF 转换为 LF。
      • 适用于:希望严格遵循 Unix LF 规则的开发者。
    3. Checkout as-is, commit as-is

      • 检出和提交时均不进行换行符转换。
      • 不推荐,可能导致跨平台兼容性问题。
  11. 配置 Git Bash 终端模拟器,用户需要选择 Git Bash 使用的终端环境,推荐保持默认,点击Next继续安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

    可选项解释如下:

    1. Use MinTTY (the default terminal of MSYS2)(默认选项)

      • 使用 MinTTY 作为 Git Bash 终端,支持可调整大小的窗口、非矩形文本选择和 Unicode 字体。
      • 需要运行 Windows 控制台程序(如交互式 Python)时,可使用 winpty 兼容。
      • 推荐选项,提供更好的终端体验
    2. Use Windows’ default console window

      • 使用 Windows 默认控制台(cmd.exe),适用于 Win32 控制台程序,如交互式 Python 或 Node.js。
      • 但字符滚动支持有限,且需要 Unicode 字体以正确显示非 ASCII 字符。
      • Windows 10 之前的版本,窗口不可自由调整大小,文本选择受限。
  12. 选择 git pull 的默认行为,用户需要指定 git pull 命令的默认合并方式,推荐保持默认,点击Next继续安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

    可选项解释如下:

    1. Fast-forward or merge(默认选项)

      • 当远程分支的提交是当前分支的直接后续提交时,执行 快进(fast-forward) 合并。
      • 如果存在分叉(当前分支有额外的本地提交),则使用 合并(merge) 方式创建合并提交。
      • 推荐选项,适用于大多数情况。
    2. Rebase

      • 使用 变基(rebase),将当前分支的提交应用到远程分支的最新提交之上,保持提交历史的线性。
      • 如果本地分支无额外提交,此选项等效于快进(fast-forward)。
      • 适用于:希望保持提交历史整洁的开发者。
    3. Only ever fast-forward

      • 仅允许 快进(fast-forward),如果无法快进(存在分叉),则操作失败。
      • 适用于:不希望自动合并提交的情况。
  13. 配置Git凭证,保持默认,点击Next继续安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  14. 配置额外选项,保持默认,点击Install开始安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  15. 等待安装完成…

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  16. 点击 Finish 完成安装。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

3. 验证 Git 安装

安装完成后,打开 命令提示符 (CMD)Git Bash,输入以下命令检查 Git 是否安装成功:

git --version

如果正确安装,会看到类似的输出(Git Bash):

手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git
命令提示符 (CMD)输出如下:

手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git


二、配置 Git(可选)

安装 Git 之后,建议立即进行 Git 配置,以便于后续使用 Git 进行代码管理。

1. 打开 Git Bash

方法一:通过右键菜单打开

  • 安装 Git 时,如果勾选了 Git Bash Here 选项,可以直接在桌面任意文件夹内右键(Windows 11 需点击“显示更多选项”),选择:Git Bash Here

方法二:通过开始菜单打开

  • Win + S 搜索 Git Bash

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

2. 配置用户信息

每次 Git 提交都会使用你的用户名和邮箱,所以需要先配置,打开 Git Bash,输入以下命令:

git config --global user.name \"你的GitHub用户名\"git config --global user.email \"你的邮箱\"

手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

3. 查看配置

可以使用以下命令查看当前 Git 配置:

git config --list

手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

4. 生成 SSH 密钥(可选,用于 GitHub 认证)

如果你计划使用 SSH 方式推送代码到 GitHub,需要生成 SSH Key 并添加到 GitHub。

1. 生成 SSH 密钥

在 Git Bash 终端输入以下命令(替换 your-email@example.com 为你的 GitHub 邮箱):

ssh-keygen -t rsa -b 4096 -C \"your-email@example.com\"

提示:执行后会提示你输入文件保存路径,直接回车即可(默认~/.ssh/id_rsa)。然后会要求你输入密码,可直接回车跳过,接着会要求你再次输入密码进行确认,再次回车跳过即可。

2. 添加 SSH Key 到 GitHub

  1. 运行以下命令复制 SSH Key:

    cat ~/.ssh/id_rsa.pub
  2. 复制输出的 SSH Key,并进入 GitHub SSH Key 管理页面,点击 New SSH Key

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  3. 填写相关信息,如下图,最后点击 Add SSH key(添加 SSH 密钥)。

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  4. 填写 GitHub账号 密码,点击 Confirm

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git

  5. 测试是否成功,打开 Git Bash,输入以下命令:

    ssh -T git@github.com

    提示:首次连接 GitHub 的 SSH 服务器时,SSH 客户端会提示你确认 GitHub 服务器的指纹是否可信,输入yes然后回车即可,如果看到 Hi your-username! You\'ve successfully authenticated (,but GitHub does not provide shell access).代表成功

    手把手教你如何在Windows上安装Git并连接GitHub_windows 安装git