如何在 Windows、macOS 和 Linux 上安装 Git

简要说明：各系统的安装方法

安装完成后，在任何系统上打开终端并执行 git --version。如果返回类似 git version 2.x.y 的内容，说明 Git 已安装并可以进行配置。

在哪里下载 Git：官方网站 git-scm

唯一的官方来源是 git-scm.com 的 Downloads 页面。网站会自动识别你的系统，并提供合适的版本。不要从第三方“软件目录”网站下载 Git 安装程序：那里可能有过时的版本，或者捆绑了广告软件。

对于 Windows，git-scm.com 会链接到 Git for Windows 的发行版（即 GitHub 上的 git-for-windows 项目）。对于 macOS 和 Linux，网站不提供单独的安装程序，而是给出包管理器的命令——这是正常的，而且更方便：之后的更新会和系统更新一起完成。

在 Windows 上安装 Git

第 1 步：下载安装程序

打开 git-scm.com，进入 Downloads → Windows，选择“64-bit Git for Windows Setup”。便携版（Portable）只适用于没有管理员权限的情况，或者你想把 Git 装在 U 盘上。搭载 ARM 处理器的电脑有单独的 ARM64 版本。

第 2 步：完成安装向导

安装程序会问很多问题，新手可能会感到紧张。大多数页面保持默认即可，但以下几个选项值得了解：

• Select Components：保留 Git Bash Here 和 Git GUI Here（资源管理器右键菜单中的选项）、Git LFS 以及文件关联。
• Choosing the default editor：默认是 Vim，新手很难从中退出。如果你装有 Visual Studio Code、Notepad++ 或 Nano，请选择它们。Git 需要你输入提交说明时，会打开这个编辑器。
• Adjusting the name of the initial branch：选择“Override the default branch name for new repositories”，并填入 main。这样新仓库的分支名会与 GitHub 保持一致。
• Adjusting your PATH environment：保留推荐选项“Git from the command line and also from 3rd-party software”。这样 git 命令在 Git Bash、PowerShell 和 VS Code 终端中都能使用。
• Choosing the SSH executable：选择 Use bundled OpenSSH。
• Choosing HTTPS transport backend：普通用户选择 OpenSSL 即可；如果在使用自有证书的企业网络中，最好选择 Windows Secure Channel。
• Configuring the line ending conversions：选择“Checkout Windows-style, commit Unix-style line endings”。这对应 core.autocrlf=true：提交到仓库时使用 LF 换行，而你本地文件中使用 CRLF。
• Configuring the terminal emulator：选择 MinTTY（Git Bash 使用的终端）。
• Credential helper：选择 Git Credential Manager。它会记住你通过浏览器登录 GitHub 的信息，这样就不必手动输入令牌。

其余页面（git pull 的行为、文件系统缓存、实验性选项）保持默认即可。

第 3 步：检查安装

从“开始”菜单打开 Git Bash，或者打开 PowerShell，然后执行：

$ git --version
git version 2.47.1.windows.1

你的版本号可能不同，关键是命令有输出。如果 PowerShell 提示“git 不是内部或外部命令”，请关闭并重新打开终端：PATH 变量只在新打开的窗口中生效。

通过 winget 安装 Git

Windows 10 和 11 内置了包管理器 winget。在 PowerShell 中一条命令即可安装：

winget install --id Git.Git -e --source winget

这种方式使用默认设置，不需要在向导中逐项选择。之后可以通过 git config 修改编辑器和分支名称。

在 macOS 上安装 Git

方式一：Apple 的命令行工具

在 macOS 上，Git 通常已经“半装”好了：第一次运行 git 时，系统会提示安装命令行工具（Command Line Tools）。也可以直接运行：

xcode-select --install

这种方式的缺点是：Apple 提供的版本随 Xcode 命令行工具一起更新，通常落后于最新版本。

方式二：Homebrew（推荐）

如果你已经安装了包管理器 Homebrew，这是最方便的方式：

brew install git
git --version
which git

在 Apple Silicon 的 Mac 上，which git 应显示 /opt/homebrew/bin/git；在 Intel 的 Mac 上则是 /usr/local/bin/git。如果显示 /usr/bin/git，说明 PATH 中排在前面的是系统自带的 Git——请打开新终端，或检查 ~/.zprofile 中是否有 Homebrew 的初始化语句。

在 Linux 上安装 Git

在 Linux 上，Git 从发行版的软件仓库安装。许多系统已经预装，因此先检查一下 git --version。

Ubuntu、Debian、Linux Mint

sudo apt update
sudo apt install git

在 Ubuntu 的 LTS 版本中，软件包可能明显落后于最新发行版。如需较新的版本，可以添加 Git 官方团队维护的 PPA：

sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install git

Fedora、RHEL、Rocky、AlmaLinux

sudo dnf install git

Arch、Manjaro

sudo pacman -S git

Alpine（例如用于 Docker 镜像）

apk add --no-cache git

在基于 Debian 的 Dockerfile 中，请使用 apt-get 而不是 apt，并清理缓存：RUN apt-get update && apt-get install -y --no-install-recommends git && rm -rf /var/lib/apt/lists/*。

如何查看 Git 版本

git --version（或 git version）会输出已安装的版本。排查问题时，详细的构建信息也很有用：

$ git version --build-options
git version 2.43.0
cpu: x86_64
sizeof-long: 8
...

版本为什么重要？因为有些命令是较新的。例如 git switch 和 git restore 从 Git 2.23 起可用，而配置项 init.defaultBranch 则从 2.28 起可用。如果某个教程的命令无法运行，先比较一下版本。

如何更新 Git

更新方式取决于 Git 的安装方式：

更新时，你的设置（~/.gitconfig）和仓库都不会被改动。Windows 安装程序会记住之前在向导中的选择，因此无需重新选择选项。

安装之后要做什么

安装 Git 只完成了一半。如果没有设置姓名和邮箱，Git 不会允许你提交，因此请立即完成最基本的配置：

git config --global user.name "Ivan Petrov"
git config --global user.email "ivan@example.com"
git config --global init.defaultBranch main
git config --global core.editor "code --wait"

最后一行将 VS Code 设为提交说明的编辑器（--wait 参数必不可少，否则 Git 不会等待你关闭窗口）。查看设置是否生效：git config --global --list。

然后用一个练习仓库检查整个流程：

mkdir hello-git && cd hello-git
git init
echo "# Hello" > README.md
git add README.md
git commit -m "First commit"
git log --oneline

安装 Git 时的常见问题

“git: command not found” 或“不是内部或外部命令”

Git 不在 PATH 中。在 Windows 上，请重新安装并选择 PATH 选项“Git from the command line and also from 3rd-party software”，然后打开新的终端。在 Linux 和 macOS 上，请用 which git 确认软件包确实已安装。

VS Code 找不到 Git

安装后请重启 VS Code。如果仍然无效，可以在设置项 git.path 中指定路径，例如 C:\Program Files\Git\cmd\git.exe。

macOS 上版本很旧，但 brew 已经安装了新版本

系统自带的 /usr/bin/git 在 PATH 中排在 Homebrew 之前。执行 eval "$(/opt/homebrew/bin/brew shellenv)"，并把这一行加入 ~/.zprofile。

在企业网络中克隆时出现 SSL 错误

网络会替换证书。在 Windows 上可以切换后端：git config --global http.sslBackend schannel。不要关闭证书验证（http.sslVerify false），那会让你暴露在中间人攻击之下。

克隆之后所有文件都显示为已修改

这是换行符问题：LF 变成了 CRLF，或者反过来。检查 git config core.autocrlf：在 Windows 上推荐 true，在 macOS 和 Linux 上推荐 input。对于团队来说，更可靠的做法是在仓库的 .gitattributes 文件中固定规则，例如写入一行 * text=auto。

选择哪种安装方式

刚开始学习时，Windows 上推荐使用官方安装程序：它展示所有重要选项，并一次性安装 Git Bash、Git Credential Manager 和 OpenSSH。有经验的用户可以选择 winget，它便于写进新电脑的环境初始化脚本，与其他软件一起部署。

在 macOS 上，如果还要安装 Node.js、Python、Docker CLI 等开发工具，建议使用 Homebrew。如果只是偶尔用到 Git，命令行工具就够了。在 Linux 上，通常发行版自带的软件包已经足够；只有当你需要较新的命令或修复，而 LTS 版本中没有时，才需要使用 PPA 中的新版本。

总结

安装 Git 很简单：Windows 上使用 git-scm.com 的官方安装程序或 winget，macOS 上使用 Homebrew，Linux 上使用发行版的包管理器。Windows 安装向导中要注意三项：编辑器、主分支名 main 和 PATH。安装后，用 git --version 检查，设置姓名和邮箱，然后就可以完成第一次提交。安装、终端配置和常用别名，在 Git 课程中有实践讲解。