002、Git安装与环境配置全攻略（Windows/macOS/Linux）

002、Git安装与环境配置全攻略（Windows/macOS/Linux）

上周帮实习生排查一个诡异问题：他本地的Git提交记录突然全乱了，git log显示的时间戳全是乱码，团队协作差点崩盘。折腾半天才发现，是他新电脑的Git区域配置根本没做，系统语言和Git时区打架。这类环境配置问题，新手踩坑率超过80%——工具没装对，后面所有操作都是空中楼阁。

一、Windows篇：绕开安装陷阱

微软商店的Git版本太旧，官网下载才是正路。安装时有几个关键选项得盯紧：

路径选择别偷懒
默认装C盘没问题，但路径里千万别带中文或空格。有些IDE插件看到空格路径就崩溃，到时候报错能让你查三天。

编辑器选择有讲究
安装程序问默认编辑器时，新手建议选Nano或Notepad++。Vim是给老手用的——你不想第一次写提交信息时，因为不会退出Vim而重启电脑吧？

# 安装后第一件事，打开CMD或PowerShell验证git--version# 看到类似 git version 2.39.0.windows.2 才算成功# 如果报“不是内部命令”，去系统环境变量里检查Path

关键一步：换行符处理
这是Windows用户专属大坑。安装时遇到“Checkout as-is, commit as-is”选项，必须选第二个“Checkout Windows-style, commit Unix-style”。理由很简单：团队里可能有macOS/Linux用户，Unix换行符（LF）是跨平台协作的标准。选错了，代码里一堆CRLF换行符，别人编译全报错。

二、macOS篇：两种路径的抉择

Homebrew方案（推荐）
如果你已经用Homebrew管理软件，一条命令最清爽：

brewinstallgit

brew会自动处理依赖和路径配置，以后升级也方便。装完记得重启终端。

官方安装包方案
去Git官网下载.dmg文件，双击安装。但要注意：macOS自带了Git，但版本老旧。安装新版本后，需要确保终端优先使用新版：

# 检查优先级whichgit# 应该显示 /usr/local/bin/git 而不是 /usr/bin/git# 如果不对，在~/.zshrc里加一行：exportPATH="/usr/local/git/bin:$PATH"

三、Linux篇：包管理器的差异

不同发行版命令不同，但思路一致——用系统包管理器装最新稳定版。

Ubuntu/Debian系

sudoaptupdatesudoaptinstallgit-y# 装完别急着用，先升级到最新版sudoadd-apt-repository ppa:git-core/ppa-ysudoaptupdatesudoaptupgradegit-y

那个PPA源是Git官方维护的，比系统默认仓库新得多。

CentOS/RHEL系

# 老版本CentOS仓库里的Git太旧了sudoyum removegit-y# 装EPEL源再装Gitsudoyuminstallepel-release-ysudoyuminstallgit-y

Arch系

sudopacman-Sgit# Arch用户应该不用我教这些...

四、装完必须做的四件事

1. 身份配置（别用全局邮箱）
很多教程让你全局配置邮箱，这是坏习惯——万一用公司电脑写个人项目，提交记录就暴露公司邮箱了。

# 先设全局默认值（可用假邮箱）gitconfig--globaluser.name"你的名字"gitconfig--globaluser.email"example@domain.com"# 针对特定项目单独配置（重要！）cd~/company-projectgitconfig user.email"your_work@company.com"cd~/personal-projectgitconfig user.email"your_real@gmail.com"

2. 默认分支改名
Git默认分支名从master改main很久了，但很多系统还没跟上：

gitconfig--globalinit.defaultBranch main

这样git init创建的新仓库分支就是main，免得每次都要改。

3. 记住密码（安全场景下）
每次push都输密码很烦人：

# Windows用Git Credential Managergitconfig--globalcredential.helper manager# macOS用Keychaingitconfig--globalcredential.helper osxkeychain# Linux用cache（密码缓存15分钟）gitconfig--globalcredential.helper cache# 或者缓存1小时gitconfig--globalcredential.helper'cache --timeout=3600'

4. 颜色和别名配置
把输出加上颜色，状态一目了然：

gitconfig--globalcolor.ui auto# 几个救命别名gitconfig--globalalias.st statusgitconfig--globalalias.co checkoutgitconfig--globalalias.br branchgitconfig--globalalias.ci commit# 现在git st就等于git status，少敲一半字母

五、验证安装：跑通这个流程

打开终端，跟着敲一遍：

mkdir~/test-git&&cd~/test-git# 建测试目录gitinit# 初始化仓库echo"# Git测试">README.md# 创建文件gitadd.# 添加到暂存区gitci-m"初始提交"# 用别名提交，应该看到彩色输出gitlog--oneline# 查看简洁提交记录

如果看到一行黄色提交哈希和提交信息，说明整个环境通路没问题。

六、环境故障排查清单

• 命令找不到：检查PATH，重启终端，Windows可能需要重启电脑
• 提交无作者信息：git config --list查看配置，确保user.name/email存在
• 中文乱码：git config --global core.quotepath false
• 代理问题：如果公司有代理，需要配置git config --global http.proxy ...

个人经验之谈

Git安装不是下载完就结束的事。我习惯在新系统装好Git后，专门花10分钟配置一套“标准环境”：统一的分支命名、带颜色的输出、那几个省时间的别名、项目隔离的邮箱配置。这套配置我备份在私有Gist里，换电脑时5分钟就能复原。

新手最容易忽略两点：一是换行符配置（特别是Windows），二是邮箱隔离。前者导致跨平台协作时出现大量虚假改动，后者可能泄露隐私。建议在团队README里加入环境检查脚本，新成员入职先跑一遍。

还有，别在虚拟机里装Git——文件系统性能太差，大仓库操作能慢到让你怀疑人生。实体机+SSD是基本尊重。

最后记住，Git配置是分层的：系统级（/etc/gitconfig）< 全局级（~/.gitconfig）< 项目级（.git/config）。优先级从低到高，项目级配置能覆盖全局设置。利用这个特性，可以灵活应对不同场景，而不是一套配置走天下。

环境配顺了，后面学习Git操作才能心无旁骛。下次我们聊仓库创建和第一次提交——那里有更多新手容易栽进去的坑。