Linux 系统 Git 安装与基础配置指南

git config --global user.name "Your Name"
git config --global user.email "[email protected]"
# 验证配置
git config --global --list

2. 配置 SSH 密钥（用于 GitHub/GitLab 等）

生成 SSH 密钥：

ssh-keygen -t ed25519 -C "[email protected]"

按提示保存密钥到默认路径（~/.ssh/id_ed25519），设置密钥密码（可选）。

将公钥添加到 GitHub/GitLab： • 复制公钥内容：

cat ~/.ssh/id_ed25519.pub

• 登录 GitHub → Settings → SSH and GPG Keys → 添加新 SSH Key。

测试 SSH 连接：

ssh -T [email protected]

成功提示：Hi username! You've successfully authenticated.

3. 配置 Git 别名（简化命令）

git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.st status
git config --global alias.lg "log --oneline --graph --all"

示例：git st 等同于 git status。

4. 启用自动换行符转换（解决跨平台换行符问题）

# Linux/macOS
git config --global core.autocrlf input
git config --global core.safecrlf warn # 检测混合换行符

三、高级设置

1. 配置差异工具（如 Meld）

安装 Meld：

# Debian/Ubuntu
sudo apt install meld -y
# CentOS/RHEL
sudo yum install meld -y

配置 Git 调用 Meld：

git config --global merge.tool meld
git config --global mergetool.meld.path "/usr/bin/meld"

2. 配置 Git 代理（解决网络问题）

# HTTP/HTTPS 代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy https://127.0.0.1:7890
# SOCKS5 代理（如 Clash）
git config --global http.proxy socks5://127.0.0.1:7890
git config --global https.proxy socks5://127.0.0.1:7890
# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy

3. 配置钩子（Hooks）自动化操作

示例：在提交前运行代码检查 • 进入仓库的 .git/hooks 目录：

cd /path/to/repo/.git/hooks

• 创建 pre-commit 文件：

#!/bin/bash
echo "Running code checks..."
npm test
# 示例：运行测试

• 赋予执行权限：

chmod +x pre-commit

四、常见问题与解决方法

1. 安装失败：E: Unable to locate package git

解决：更新软件源并重试：

sudo apt update && sudo apt install git -y

2. 权限错误：Permission denied (publickey)

解决：

1. 检查公钥是否正确添加到 GitHub/GitLab。
2. 确认 SSH 密钥已添加到 ssh-agent：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

3. Git 版本过旧

升级 Git：

# Debian/Ubuntu
sudo add-apt-repository ppa:git-core/ppa -y
sudo apt update && sudo apt upgrade git -y
# Fedora
sudo dnf upgrade git -y

4. 终端提示 git: command not found

解决： • 检查是否已安装：which git。 • 若未安装，通过上述方法重新安装。 • 确保 Git 路径在环境变量中（echo $PATH）。

五、卸载 Git

1. 通过包管理器卸载

• Debian/Ubuntu：

sudo apt remove git -y

• CentOS/RHEL：

sudo yum remove git -y

2. 手动卸载（源码安装）

sudo rm -rf /usr/local/bin/git
sudo rm -rf /usr/local/share/doc/git

六、学习资源推荐

1. Pro Git 电子书（免费）：https://git-scm.com/book/zh/v2
2. GitHub 官方教程：https://guides.github.com/
3. Git 命令速查表：https://education.github.com/git-cheat-sheet-education.pdf