Git从零安装到起飞配置指南（手把手教学版）

最新推荐文章于 2025-05-03 23:40:21 发布

原创最新推荐文章于 2025-05-03 23:40:21 发布 · 586 阅读

20 ·

CC 4.0 BY-SA版权

文章标签：

#git #其他

一、为什么你的Git总出幺蛾子？（必看前言）

各位程序猿/媛注意了！（敲黑板！）90%的Git报错问题都源于安装配置不当！今天这个教程我掏心窝子把Windows、Mac、Linux三大系统的安装配置全流程拆开揉碎了讲，看完还不会你顺着网线来找我！

二、安装篇：不同系统保姆级教程

2.1 Windows用户看这里（附避坑指南）

官网下载地址：https://git-scm.com/download/win
（千万别在第三方网站下！血的教训！）
双击安装包后重点注意：
- 选择VSCode作为默认编辑器（别用vim！新手会哭！）
- 勾选"Git from the command line and also…"（重要！）
- 换行符选"Checkout as-is…"（防乱码必选项）
验证安装成功：
```
git --version
```
看到类似git version 2.37.1.windows.1就稳了！

2.2 Mac用户两种姿势

方式一：Homebrew大法（推荐）

brew install git

（没有Homebrew？终端输入/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）

方式二：安装包直装

下载地址：https://git-scm.com/download/mac

2.3 Linux用户分步走

# Debian/Ubuntu系
sudo apt-get update && sudo apt-get install git -y

# CentOS系
sudo yum install git -y

三、配置篇：这些设置让你效率翻倍

3.1 用户身份认证（不配置提交记录全是unknown！）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

（注意：邮箱要和GitHub/GitLab注册邮箱一致！）

3.2 超实用全局配置（建议全开）

# 显示彩色输出
git config --global color.ui auto

# 设置默认编辑器为VSCode
git config --global core.editor "code --wait"

# 记住密码15分钟（不用每次都输密码）
git config --global credential.helper cache
git config --global credential.helper 'cache --timeout=900'

3.3 SSH密钥配置（免密推送必备）

生成密钥：
```
ssh-keygen -t ed25519 -C "你的邮箱"
```
（出现提示直接按回车，别设密码！）
查看公钥：
```
cat ~/.ssh/id_ed25519.pub
```
复制到GitHub/GitLab的SSH Keys设置页

四、新手常见翻车现场（附解决方案）

4.1 报错：'git’不是内部命令

👉 解决方案：安装时没勾选"Add to PATH"，去环境变量手动添加Git安装目录\cmd

4.2 SSH连接失败

👉 检查三件套：

是否生成密钥对
公钥是否添加到远程仓库
执行ssh -T git@github.com测试

4.3 中文乱码问题

在git bash执行：

git config --global core.quotepath false

五、进阶配置：让Git更好用的秘密武器

5.1 配置别名（偷懒神器）

git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch

现在可以用git st代替git status了！

5.2 图形化工具推荐

VSCode自带的Git工具（已安装的不用额外装）
Sourcetree（可视化操作超友好）

5.3 .gitconfig文件详解

打开~/.gitconfig能看到所有配置项，可以直接编辑：

[alias]
    lol = log --graph --decorate --pretty=oneline --abbrev-commit
    lola = log --graph --decorate --pretty=oneline --abbrev-commit --all

六、终极验证：完整流程测试

新建测试目录
```
mkdir git-test && cd git-test
```
初始化仓库
```
git init
```

新建文件并提交

echo "Hello Git" > test.txt
git add .
git commit -m "first commit"

看到类似[master (root-commit) 8a3c6e2] first commit就说明配置成功！

七、配置备份与迁移（换电脑不用慌）

你的所有配置都在以下位置：

Windows：C:\Users\用户名\.gitconfig
Mac/Linux：~/.gitconfig

直接复制这个文件到新电脑就能继承所有配置！（爽不爽？）

八、写在最后

这套配置方案是我踩过无数坑总结出来的黄金组合，尤其适合国内开发环境。如果遇到玄学问题，记住三板斧：

检查网络（特别是github经常抽风）
重启终端
更新git到最新版

有任何问题欢迎评论区开怼，看到必回！下期预告：《Git骚操作：用rebase让提交记录美如画》