【工具】Git版本控制工具安装与基础使用指南

一、多平台安装方法

1. Windows系统安装

1. 访问官网下载安装包：https://git-scm.com
2. 选择最新稳定版（当前推荐2.37.0）
3. 关键安装选项：

[必选] 添加Git到系统PATH
[推荐] 集成Windows资源管理器右键菜单
[建议] 选择VSCode作为默认编辑器
[重要] 配置换行符转换：
  → 检出时转换为Windows风格
  → 提交时转换为UNIX风格

2. macOS系统安装

# 通过Homebrew安装（推荐）
brew install git

# 或下载官方安装包
# 访问：https://sourceforge.net/projects/git-osx-installer/

3. Linux系统安装

# Debian/Ubuntu
sudo apt install git-all

# CentOS/RHEL
sudo yum install git

# 编译安装最新版
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.37.0.tar.gz
tar -zxvf git-2.37.0.tar.gz
cd git-2.37.0
make prefix=/usr/local all
sudo make prefix=/usr/local install

二、基础配置（首次使用必做）

1.全局身份配置

git config --global user.name "YourName"
git config --global user.email "[email protected]"

2. 提高使用体验

# 开启颜色高亮
git config --global color.ui true

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

# 配置文件查看路径
~/.gitconfig

三、基础操作命令手册

1. 仓库生命周期管理

操作	命令	说明
初始化仓库	git init	创建新仓库
克隆远程仓库	git clone	下载已有项目
查看当前状态	git status -sb	简洁状态显示
添加所有变更	git add -A	包括新增/修改/删除/重命名
提交变更	git commit -m “描述”	提交到本地仓库
查看提交历史	git log --oneline --graph	图形化简洁日志

2. 文件操作示例流程

# 创建并进入项目目录
mkdir myproject && cd myproject

# 初始化Git仓库
git init

# 创建README文件
echo "# My Project" > README.md

# 添加并提交
git add README.md
git commit -m "Initial commit"

# 查看提交历史
git log

四、远程仓库操作指南

1. 连接GitHub/Gitee

# 添加远程仓库（以GitHub为例）
git remote add origin https://github.com/username/repo.git

# 查看远程连接
git remote -v

# 推送本地分支
git push -u origin main

# 拉取远程更新
git pull origin main

2. SSH密钥配置

# 生成密钥对（默认保存路径~/.ssh）
ssh-keygen -t ed25519 -C "[email protected]"

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

# 添加到GitHub：Settings → SSH and GPG keys

五、分支操作命令

# 创建新分支
git branch dev

# 切换分支
git checkout dev

# 创建并切换分支
git checkout -b feature/login

# 合并分支到main
git checkout main
git merge feature/login

# 删除已合并分支
git branch -d feature/login

六、常见问题解决方案

1. 错误代码速查表

错误现象	解决方案
提交时提示权限不足	检查SSH密钥配置
合并冲突	使用git mergetool解决冲突
误提交敏感文件	使用git rm --cached移除
提交信息写错	git commit --amend修改

2. 紧急回滚操作

# 撤销本地修改（单个文件）
git checkout -- filename

# 重置到最后提交状态
git reset --hard HEAD

# 回退到指定提交
git reset --hard commit_id

七、图形化工具推荐

1. 内置工具

# 启动图形化界面
git gui

# 查看提交历史
gitk

2. 第三方工具

工具名称	平台支持	特色功能
GitHub Desktop	Win/Mac	与GitHub深度整合
SourceTree	Win/Mac	可视化分支管理
GitKraken	全平台	强大的合并冲突解决工具

八、高效使用技巧

1. 命令别名设置

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

2. 忽略文件配置

创建.gitignore文件：

# 忽略编译文件
*.exe
*.dll
*.so

# 忽略IDE配置
.vscode/
.idea/

# 忽略依赖目录
node_modules/