Git 环境搭建与配置最佳实践

面向初学者的 Git 入门指南：各平台安装方法 + 必做的初始配置

一、安装 Git

平台	安装方式
Windows	从官网 https://git-scm.com/install/ 下载安装包，双击运行即可
macOS	系统自带 Git，无需安装
Linux	命令安装：sudo apt-get install git

安装完成后，打开终端执行以下命令验证：

git --version

能输出版本号即表示安装成功。

二、配置 Git

1. 配置命令

git config -l              # 查看当前生效的所有配置
git config 键              # 查看某个配置的值
git config --范围 键 "值"   # 更新配置

2. 配置范围

配置可以作用于不同的范围（级别），常用的是 local 和 global：

范围	作用域	说明
local	仅当前仓库	【默认】【常用】仓库级别的个性配置
global	当前用户的所有仓库	【常用】用户级别的通用配置
system	所有用户	很少使用
worktree	仅当前工作树	很少使用

优先级（从高到低）：

worktree > local > global > system

即：范围越小的配置，优先级越高。同一配置项，local 会覆盖 global。

3. local 和 global 怎么选？

一句话原则：通用配置放 global，个别仓库的特殊需求用 local 覆盖。

什么时候用 global？

场景：配置对所有仓库都一样，只设一次，一劳永逸。

• 刚装好 Git，设置自己的用户名和邮箱
• 设置默认编辑器、默认分支名等个人习惯

git config --global user.name "张三"
git config --global user.email "zhangsan@person.com"

✅ 解决的问题：不用每个仓库都重复配置一遍。

什么时候用 local？

场景：某个仓库需要「不一样的身份或行为」，不能影响其他仓库。

最典型的例子——公司项目和个人项目用不同邮箱：

# 全局默认是个人邮箱
git config --global user.email "zhangsan@personal.com"

# 进入公司项目的仓库目录，单独覆盖为公司邮箱
cd company-project
git config user.email "zhangsan@company.com"   # 省略 --local，默认就是 local

这样：

• 提交公司代码 → 记录的是公司邮箱 ✅
• 提交个人项目 → 记录的还是个人邮箱 ✅

✅ 解决的问题：避免「用错身份提交」的尴尬，同时不用每次切换项目都改全局配置。

配合优先级理解

正因为 local > global，所以 local 非常适合做局部覆盖：

global 提供默认值  ←  所有仓库生效
   ↓ 某个仓库不满意默认值
local 覆盖它      ←  只影响这一个仓库

4. 常见配置项

配置项	说明
user.name	【必配】用户名，每次提交都会记录
user.email	【必配】邮箱，每次提交都会记录
core.editor	默认文本编辑器（如 commit 时打开）
core.ignorecase	是否忽略文件名大小写，默认 true（忽略）
init.defaultbranch	git init 后默认的分支名

5. 推荐的初始配置（首次安装后执行）

# 必配：用户名和邮箱（提交记录会附带这些信息）
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# 选配：默认编辑器设为 VS Code
git config --global core.editor "code --wait"

# 选配：不忽略文件名大小写
git config --global core.ignorecase false

# 选配：默认分支名设为 main
git config --global init.defaultbranch "main"

三、配置检查清单

安装配置完成后，可以用下面的命令核对：

git config -l

确认输出中至少包含：

• ✅ user.name=你的名字
• ✅ user.email=你的邮箱

完成以上两步，Git 就可以正常使用了 🎉