01. Git 装完不会配？Windows/macOS/Linux 三端配置一次到位

发表于 分类于
装好 Git 只是第一步，用户名、邮箱、终端配色、默认分支没配好，后面全是坑。三端安装 + 基础环境配置，一篇搞定。

「Git」系列已发布： 00. 改崩代码不敢回退？Git 版本控制 3 分钟救你狗命 ｜ 01. Git 装完不会配？Windows/macOS/Linux 三端配置一次到位（本文）

装好 Git 只是第一步，用户名、邮箱、终端配色、默认分支没配好，后面全是坑。三端安装 + 基础环境配置，一篇搞定。

以下内容覆盖三种主流环境：

  • macOS 26.x（Apple Silicon / Intel）
  • Ubuntu 24.04 LTS / CentOS Stream 9
  • Windows 11（22H2 及以上）
    如果你是零基础，建议先看完系列开篇《Git 简介与版本控制概念》，对版本控制有个基本概念再动手。

一、各平台安装方式概览

不同系统上的安装路径差别挺大，先拉一张总表：

操作系统 首选方式 备选
macOS Homebrew Xcode Command Line Tools / 官方 .dmg
Linux (Debian/Ubuntu) apt 源码编译
Linux (RHEL/CentOS) dnf/yum 源码编译 / IUS 仓库
Windows Git for Windows winget / Chocolatey / WSL2 内安装

1.1 macOS 上安装 Git

1.1.1 Homebrew（最省事）

macOS 上没装 Homebrew 的话会少很多便利，强烈建议搞一个。通过它装的 Git 版本最新，而且升级和切换版本都很方便。


# 如果还没装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Git
brew install git

# 验证
git --version

# 输出示例：git version 2.48.1

日常维护：

brew upgrade git           # 升级到最新版
brew info git              # 查看版本信息与依赖

1.1.2 Xcode Command Line Tools（系统自带）

不想装 Homebrew 的话，macOS 自带的 Xcode Command Line Tools 里也有 Git：

xcode-select --install

弹窗点"安装"，完事验证：

git --version

# 输出示例：git version 2.39.5 (Apple Git-154)

捆绑的 Git 版本通常比官方慢一拍，更新跟着系统走。

要是你用到新特性（比如 partial clone 之类的），还是 Homebrew 靠谱。

1.2 官方安装包

去 (git-scm.com/download/mac) 下.dmg。适合不习惯命令行的朋友，但每次升级得手动去下新版本。

1.3 Linux 上安装 Git

1.3.1 Debian / Ubuntu

# 先更新索引
sudo apt update

# 安装
sudo apt install git -y

# 看看版本
git --version

官方仓库里的 Git 可能比较老，想要最新的走 PPA：

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

1.3.2 RHEL / CentOS / Fedora

# RHEL 8/9 及 CentOS Stream 9
sudo dnf install git -y

# CentOS 7 等老版本
sudo yum install git -y

# 查看版本
git --version

想要更新一点的版本，Fedora/RHEL 系可以走 IUS 仓库或直接源码编译：

# 启用 IUS 仓库（CentOS 7 示例）
sudo yum install -y https://repo.ius.io/ius-release-el7.rpm
sudo yum install -y git236

1.3.3 源码编译（所有发行版通用）

需要特定版本或自定义编译选项时用这招：

# 安装编译依赖
sudo apt install -y dh-autoreconf libcurl4-gnutls-dev libexpat1-dev \
gettext libz-dev libssl-dev

# 下源码
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.48.1.tar.gz
tar -zxf git-2.48.1.tar.gz
cd git-2.48.1

# 编译安装
make configure
./configure --prefix=/usr/local
make all doc info
sudo make install install-doc install-html install-info

# 验证
/usr/local/bin/git --version

1.4 Windows 上安装 Git

1.4.1 Git for Windows（官方方案）

去 https://git-scm.com/download/win 下载安装程序。

安装向导里有几个选项值得注意：

安装步骤 怎么选 为什么
选择组件 勾上 Git Bash Here、Git GUI Here 右键菜单加快捷入口
默认编辑器 选自己顺手的（比如 VS Code） 影响 commit、rebase -i 打开的编辑器
调整 PATH Git from the command line and also from 3rd-party software CMD 和 PowerShell 都能用
HTTPS 传输后端 Use the OpenSSL library 兼容性最好
换行符处理 Checkout Windows-style, commit Unix-style 跨平台协作标配
终端模拟器 Use MinTTY 比 Windows 自带控制台好用
默认 pull 行为 Fast-forward or merge 标准行为
凭据管理器 Git Credential Manager 自动管 HTTPS 凭据
额外选项 勾上 Enable file system caching 提升性能

1.4.2 winget（Windows 11 自带）

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

1.4.3 Chocolatey

choco install git -y

1.4.4 WSL2 环境

在 WSL2 里建议单独装 Git，不要依赖 Windows 宿主机的。进 WSL2 的 Linux 发行版，走对应的 Linux 安装命令就行。

1.5 装完先配什么

Git 装好之后，至少把用户名和邮箱设了，不然没法 commit：

# 用户名（标识每次提交的作者）
git config --global user.name "Your Name"

# 邮箱（和托管平台账号邮箱保持一致）
git config --global user.email "your.email@example.com"

# 确认生效
git config --global --list

--global是全局配置，作用于当前用户的所有仓库。

关于 Git 三层配置体系的细节（系统级、全局级、仓库级怎么协作），下一篇《Git 配置详解》会展开。

另外这几个配置项也建议顺手设了：

# 默认分支名改成 main
git config --global init.defaultBranch main

# 命令行彩色输出
git config --global color.ui auto

# 默认编辑器设成 VS Code
git config --global core.editor "code --wait"

# 换行符策略（Windows 用户建议）
git config --global core.autocrlf input

1.6 确认装好了没

跑几个命令验证：

# 看版本
git --version

# 看系统配置路径和编译信息
git version --build-options

# 列出所有已安装的 Git 命令
git help -a

三条都正常输出，说明搞定，可以进下一篇开始深入配置和实操了。

1.7 常见安装问题

1.7.1 macOS: git command not found

装了 Homebrew 版 Git 但提示找不到命令，查一下 PATH：

echo $PATH | grep brew

# 应该有 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）
# 缺了的话，在 ~/.zshrc 里加一行
export PATH="/opt/homebrew/bin:$PATH"
source ~/.zshrc

1.7.2 macOS：xcrun: error

Xcode Command Line Tools 路径异常：

xcode-select --reset
sudo xcode-select --switch /Library/Developer/CommandLineTools

1.7.3 Linux：apt 装的版本太老

走 PPA 拿最新版，见上面 Debian/Ubuntu 那节。

1.8 Windows 常见问题

git clone 报 SSL 证书错误

企业内网里常见，代理或防火墙拦了 HTTPS：


# 临时跳过 SSL 验证（生产环境别这么干）
git config --global http.sslVerify false

# 正解：配企业 CA 证书
git config --global http.sslCAInfo /path/to/your-ca-bundle.crt

二、文章引用

上一篇：00. 改崩代码不敢回退？Git 版本控制 3 分钟救你狗命

📌 本文首发于微信公众号 【运维知识点滴】——专注运维实战干货，微信搜索“运维知识点滴”或扫下方二维码关注，更新不迷路。
📎 微信原文：01. Git 装完不会配？Windows/macOS/Linux 三端配置一次到位

微信公众号【运维知识点滴】 微信小程序【A5单据合并&大试卷拆分转A4打印】
运维实战干货 · 关注追更 Word 转 PDF · 试卷/发票打印神器 · 免费
运维实战干货 · 关注追更 Word 转 PDF · 试卷/发票打印神器 · 免费

💡 小程序【A5单据合并&大试卷拆分转A4打印】是干嘛的？ 一个 Word 转 PDF 的打印神器，专治“文档版式和打印机对不上”：

  • A3 试卷打不出来？ 学校发的电子版试卷多是 A3，家用打印机只吃 A4——上传 Word 一键转换：可缩到一页 A4（页数不变），也可对半拆成两张 A4（1:1 原大、字更清晰），两种模式自选；
  • 版式不乱：真实渲染引擎原样转换、绝不重排内容，转出的 PDF 和原 Word 排版一致，公式/表格/图片不跑版；
  • 两张 A5 单据拼一张 A4：出租车票、火车票等报销凭证拼版后，一次打印、整齐粘贴；
  • 隐私省心：无需注册，转换结果留存 5 天、最多下载 5 次即自动删除，不留任何历史记录；
  • 微信扫码即用，免费、免安装，支持 doc / docx（≤50MB）。