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管理软件一条命令最清爽brewinstallgitbrew会自动处理依赖和路径配置以后升级也方便。装完记得重启终端。官方安装包方案去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-yArch系sudopacman-Sgit# Arch用户应该不用我教这些...四、装完必须做的四件事1. 身份配置别用全局邮箱很多教程让你全局配置邮箱这是坏习惯——万一用公司电脑写个人项目提交记录就暴露公司邮箱了。# 先设全局默认值可用假邮箱gitconfig--globaluser.name你的名字gitconfig--globaluser.emailexampledomain.com# 针对特定项目单独配置重要cd~/company-projectgitconfig user.emailyour_workcompany.comcd~/personal-projectgitconfig user.emailyour_realgmail.com2. 默认分支改名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.helpercache --timeout36004. 颜色和别名配置把输出加上颜色状态一目了然gitconfig--globalcolor.ui auto# 几个救命别名gitconfig--globalalias.st statusgitconfig--globalalias.co checkoutgitconfig--globalalias.br branchgitconfig--globalalias.ci commit# 现在git st就等于git status少敲一半字母五、验证安装跑通这个流程打开终端跟着敲一遍mkdir~/test-gitcd~/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操作才能心无旁骛。下次我们聊仓库创建和第一次提交——那里有更多新手容易栽进去的坑。