# Git Linux 安装与配置

> 📚 Git 教程系列 - 第 3 篇  
> 📅 最后更新：2026-03-15  
> 🐧 适用系统：Ubuntu/Debian/CentOS/Arch

---

## 📥 第一步：安装 Git

### Ubuntu/Debian 系统

```bash
# 更新软件包列表
sudo apt update

# 安装 Git
sudo apt install git -y

# 验证安装
git --version
```

### CentOS/RHEL 系统

```bash
# 安装 EPEL 仓库（CentOS 7/8）
sudo yum install epel-release -y

# 安装 Git
sudo yum install git -y

# 或使用 dnf（CentOS 8+/Fedora）
sudo dnf install git -y

# 验证安装
git --version
```

### Arch Linux/Manjaro

```bash
# 安装 Git
sudo pacman -S git

# 验证安装
git --version
```

### openSUSE

```bash
# 安装 Git
sudo zypper install git

# 验证安装
git --version
```

---

## ⚙️ 第二步：配置 Git

### 全局配置（必须）

```bash
# 配置用户名
git config --global user.name "Deshill"

# 配置邮箱
git config --global user.email "your-email@example.com"

# 配置默认分支名（Git 2.28+）
git config --global init.defaultBranch main

# 配置编辑器（推荐 Nano 或 Vim）
git config --global core.editor nano

# 或配置 VS Code（如果已安装）
git config --global core.editor "code --wait"
```

### 查看配置

```bash
# 查看所有配置
git config --list

# 查看某个配置
git config user.name
git config user.email

# 查看配置文件位置
echo ~/.gitconfig
```

### 编辑配置文件

```bash
# 使用 nano 编辑
nano ~/.gitconfig

# 或使用 vim
vim ~/.gitconfig
```

配置文件内容示例：
```ini
[user]
    name = Deshill
    email = your-email@example.com
[core]
    editor = nano
    autocrfl = false
[init]
    defaultBranch = main
```

---

## 🔑 第三步：配置 SSH 密钥

### 生成 SSH 密钥

```bash
# 生成新密钥（推荐 ed25519 算法）
ssh-keygen -t ed25519 -C "your-email@example.com"

# 如果系统不支持 ed25519，使用 rsa
ssh-keygen -t rsa -b 4096 -C "your-email@example.com"
```

**按提示操作：**
```
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/你的用户名/.ssh/id_ed25519): [直接回车]
Enter passphrase (empty for no passphrase): [直接回车或输入密码]
Enter same passphrase again: [再次输入]
```

### 查看生成的密钥

```bash
# 查看 .ssh 目录
ls -la ~/.ssh/

# 查看公钥内容
cat ~/.ssh/id_ed25519.pub

# 输出示例
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... your-email@example.com
```

### 添加 SSH 密钥到 SSH Agent

```bash
# 启动 ssh-agent
eval "$(ssh-agent -s)"

# 添加密钥
ssh-add ~/.ssh/id_ed25519

# 如果设置了密码，会提示输入
```

### 添加到 GitHub/Gitee

**GitHub:**
1. 访问：https://github.com/settings/keys
2. 点击 **New SSH key**
3. 粘贴 `~/.ssh/id_ed25519.pub` 的内容
4. 点击 **Add SSH key**

**Gitee:**
1. 访问：https://gitee.com/profile/sshkeys
2. 点击 **添加 SSH 密钥**
3. 粘贴公钥内容
4. 点击 **确定**

### 测试连接

```bash
# 测试 GitHub
ssh -T git@github.com

# 首次连接会提示确认
The authenticity of host 'github.com (xxx.xxx.xxx.xxx)' can't be established.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes

# 成功输出
Hi Deshill! You've successfully authenticated...

# 测试 Gitee
ssh -T git@gitee.com

# 成功输出
Welcome to Gitee! Deshill, You've successfully authenticated...
```

---

## 🎨 第四步：美化终端（可选）

### 安装 Oh My Zsh（推荐）

```bash
# 安装 zsh
sudo apt install zsh -y        # Ubuntu/Debian
sudo yum install zsh -y        # CentOS
sudo pacman -S zsh             # Arch

# 安装 Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# 切换默认 shell 为 zsh
chsh -s $(which zsh)

# 重新登录或重启终端
```

### 安装主题

```bash
# 克隆 powerlevel10k 主题
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# 编辑 .zshrc
nano ~/.zshrc

# 修改主题
ZSH_THEME="powerlevel10k/powerlevel10k"

# 重新加载配置
source ~/.zshrc
```

### 安装 Git 插件

```bash
# 克隆 git 插件
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# 编辑 .zshrc，添加插件
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

# 重新加载
source ~/.zshrc
```

---

## 🚀 第五步：常用 Linux 命令

### 基本导航

```bash
# 查看当前目录
pwd

# 列出文件
ls
ls -la      # 显示隐藏文件
ll          # 详细列表（别名）

# 切换目录
cd ~/projects
cd ..       # 返回上级
cd ~        # 返回家目录
cd -        # 返回上一个目录

# 创建目录
mkdir my-project
cd my-project
```

### 文件操作

```bash
# 创建文件
touch README.md

# 编辑文件
nano README.md
vim README.md
code README.md    # 如果安装了 VS Code

# 复制文件
cp file1.txt file2.txt
cp -r folder1 folder2    # 复制文件夹

# 移动/重命名文件
mv old.txt new.txt
mv file.txt /path/to/destination/

# 删除文件
rm file.txt
rm -rf folder    # 删除文件夹（谨慎！）

# 查看文件内容
cat file.txt
less file.txt     # 分页查看
head file.txt     # 查看前 10 行
tail file.txt     # 查看后 10 行
```

### 文本编辑

```bash
# Nano 编辑器（简单）
nano file.txt
# Ctrl+O 保存，Ctrl+X 退出

# Vim 编辑器（强大）
vim file.txt
# i 进入插入模式
# Esc 退出插入模式
# :wq 保存并退出
# :q! 不保存退出
```

---

## 📁 第六步：第一个 Git 项目

### 创建项目

```bash
# 在家目录创建项目文件夹
cd ~
mkdir my-first-git-project
cd my-first-git-project

# 初始化为 Git 仓库
git init

# 创建 README 文件
echo "# My First Git Project" > README.md
echo "" >> README.md
echo "这是我的第一个 Git 项目！" >> README.md

# 查看状态
git status
```

### 提交代码

```bash
# 添加到暂存区
git add README.md

# 或添加所有文件
git add .

# 提交
git commit -m "初始化项目"

# 查看日志
git log
git log --oneline    # 简洁显示
```

### 连接远程仓库

```bash
# 添加远程仓库
git remote add origin git@github.com:Deshill/my-first-git-project.git

# 查看远程仓库
git remote -v

# 推送
git push -u origin main

# 如果远程分支不存在
git push -u origin master
```

---

## 🛠️ 第七步：常见问题解决

### 问题 1：权限错误

```bash
# 方法 1：使用 sudo（不推荐）
sudo git clone ...

# 方法 2：修改目录权限
sudo chown -R $USER:$USER /path/to/project

# 方法 3：重新配置 SSH 密钥
ssh-keygen -t ed25519 -C "your-email@example.com"
```

### 问题 2：中文乱码

```bash
# 配置 Git 显示中文
git config --global core.quotepath false
git config --global gui.encoding utf-8
git config --global i18n.commitencoding utf-8
git config --global i18n.logoutputencoding utf-8

# 配置终端
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

# 永久生效，添加到 ~/.bashrc 或 ~/.zshrc
echo "export LANG=zh_CN.UTF-8" >> ~/.bashrc
echo "export LC_ALL=zh_CN.UTF-8" >> ~/.bashrc
source ~/.bashrc
```

### 问题 3：SSL 证书验证失败

```bash
# 方法 1：更新 CA 证书
sudo apt install ca-certificates -y    # Ubuntu/Debian
sudo yum update ca-certificates -y     # CentOS

# 方法 2：禁用 SSL 验证（不推荐）
git config --global http.sslVerify false
```

### 问题 4：Git 命令找不到

```bash
# 检查 Git 是否安装
which git

# 如果没输出，重新安装
sudo apt install git -y        # Ubuntu/Debian
sudo yum install git -y        # CentOS
sudo pacman -S git             # Arch

# 添加到 PATH（如果安装在其他位置）
export PATH=$PATH:/usr/local/git/bin
echo "export PATH=$PATH:/usr/local/git/bin" >> ~/.bashrc
source ~/.bashrc
```

### 问题 5：SSH 连接失败

```bash
# 检查 SSH 密钥
ls -la ~/.ssh/

# 检查公钥是否添加到 GitHub/Gitee
cat ~/.ssh/id_ed25519.pub

# 测试连接
ssh -vT git@github.com    # -v 显示详细信息

# 修复权限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub
```

### 问题 6：推送到远程失败

```bash
# 检查远程仓库配置
git remote -v

# 重新设置远程仓库
git remote set-url origin git@github.com:Deshill/my-project.git

# 检查分支名
git branch -a

# 如果远程是 master 分支
git push -u origin master
```

---

## 📋 配置检查清单

安装完成后，检查以下项目：

- [ ] Git 已安装（`git --version`）
- [ ] 用户名已配置（`git config user.name`）
- [ ] 邮箱已配置（`git config user.email`）
- [ ] SSH 密钥已生成（`ls -la ~/.ssh/`）
- [ ] SSH 密钥已添加到 GitHub/Gitee
- [ ] SSH 连接测试成功（`ssh -T git@github.com`）
- [ ] 中文显示正常
- [ ] 能正常创建和提交项目

---

## 🎯 小结

| 步骤 | 内容 | 命令 |
|------|------|------|
| 1 | 安装 Git | `apt/yum/pacman install git` |
| 2 | 配置用户 | `git config --global user.name/email` |
| 3 | 配置 SSH | `ssh-keygen -t ed25519` |
| 4 | 测试连接 | `ssh -T git@github.com` |
| 5 | 创建项目 | `git init` |
| 6 | 提交代码 | `git add` + `git commit` |
| 7 | 推送远程 | `git push -u origin main` |

---

## 📚 扩展阅读

- [Git 官方文档](https://git-scm.com/doc)
- [GitHub 帮助](https://docs.github.com/zh/authentication/connecting-to-github-with-ssh)
- [Gitee 帮助](https://gitee.com/help/articles/4181)

---

> 💡 **下一步**：继续学习 [04-常用命令与实战](./04-常用命令与实战.md)