Git 安装指南：Windows / macOS / Linux 安装与首次配置

三句话装好 Git

• 安装只有两步：装二进制 + 首次配置（user.name / user.email）。
• Windows 用 Git for Windows（自带 Git Bash）；macOS 用 Xcode 命令行工具或 Homebrew；Linux 用发行版包管理器。
• 装完先跑 git --version 确认版本，再配好身份——不配身份，第一次 commit 就报错。

Windows：Git for Windows

从 git-scm.com 下载安装包（国内慢可看《平台实战》的加速章节）。安装向导里建议这样选：

装完开始菜单会多出 Git Bash / Git CMD / Git GUI，日常用 Git Bash 最省心。

git --version

macOS：两条路

• 最省事：xcode-select --install，装命令行工具，自带 git
• 常更新：brew install git，Homebrew 的版本通常更新
• 验证：git --version；which -a git 可看是否装了多份

xcode-select --install
brew install git
git --version

Linux：包管理器

# Debian / Ubuntu
sudo apt update && sudo apt install git
# Fedora / RHEL
sudo dnf install git
# Arch
sudo pacman -S git

日常用发行版自带包就够；确实需要最新版，再考虑官方 PPA 或源码编译。

首次配置：一次配好，长期省事

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global core.autocrlf input      # Windows 改为 true
git config --global core.quotepath false     # 中文文件名正常显示
git config --global credential.helper manager
git config --global core.editor "code --wait"

• --global 写进 ~/.gitconfig，对本机所有仓库生效；仓库内 --local 可覆盖它
• 身份邮箱建议与代码托管平台账号一致，提交才会正确归属到你
• core.autocrlf：Windows 用 true，macOS / Linux 用 input，团队统一才不会互相改行尾

验证安装是否真的可用

git --version
git config --list --show-origin      # 看每项配置来自哪个文件
git config --global --list

• 能打印版本、能列出配置，就说明装好了
• 想验证远程认证：ssh -T git@github.com（详见《平台实战》）

常见报错与处理