Git环境配置方法:Windows、macOS、Linux三步搞定

刚接触Git,第一件事不是写代码,而是把环境配好。很多人卡在第一步:装完Git却提示command not found,或者git --version没反应——其实是PATH没通,或者安装时漏勾了关键选项。

Windows系统:别跳过‘添加到PATH’

git-scm.com下载最新安装包(.exe),双击运行后,一路下一步,关键在第6步‘Adjusting your PATH environment’:

✅ 务必选中:‘Git from the command line and also from 3rd-party software’(这样cmd、PowerShell、VS Code终端都能直接用git)

安装完打开命令提示符,输入:

git --version

看到类似 git version 2.43.0.windows.1 就算成功。如果报错,右键‘此电脑’→‘属性’→‘高级系统设置’→‘环境变量’,检查Path里是否包含类似C:\Program Files\Git\cmd的路径。

macOS:Homebrew最省心,但别忘了xcode-select

如果你已装Homebrew,终端里敲:

brew install git

没装的话,先跑:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

装完别急着用,先执行:

xcode-select --install

这是为了补全命令行开发工具(包括git依赖的编译器和证书工具)。之后再验证:

git --version

如果还提示command not found,检查shell配置文件(~/.zshrc~/.bash_profile),确认是否有export PATH="/opt/homebrew/bin:$PATH"这一行。

Linux(Ubuntu/Debian系):一行命令+两步验证

终端里直接输入:

sudo apt update && sudo apt install git -y

装完立刻验证版本:

git --version

再顺手配个基础用户信息(不然下次commit会报错):

git config --global user.name "你的名字"
git config --global user.email "you@example.com"

注意:邮箱不一定要真实,但得是合法格式;名字建议用英文或拼音,避免中文路径乱码问题。

小技巧:快速确认Git是否真就位

别只信--version,试试这个命令:

which git

它会返回Git可执行文件的真实路径,比如/usr/bin/git/opt/homebrew/bin/git。如果空白,说明系统根本找不到git,得回头检查安装或PATH。

常见翻车现场

  • Windows装完用的是Git Bash,但在CMD里输git没反应 → 换成Git Bash窗口,或按前面说的重装并勾选PATH选项
  • Mac上用MacPorts装的git,结果和Homebrew冲突 → 卸载一个,统一用brew管理更稳妥
  • Linux用sudo snap install git装的,但snap版默认禁用外部访问 → 改用apt装,更轻量也更兼容