刚接触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装,更轻量也更兼容