Git 使用指南#

核心概念
Git 的核心是记录更改，记住这个原则也就理解了 Git 的基本原理。至于其方法，无非推拉二字。

提前准备#

环境要求
在开始之前，请确保你已经准备好以下内容：
Git 客户端（下载地址）
GitHub 账号（注册地址）
稳定的网络条件

一、Git 初始配置#

重要配置
这些配置信息会随着你的每一次提交保存在仓库中，请确保使用正确的信息。

在 Git 命令行输入以下命令，配置 name 和 email：

## 换成你的 name
git config --global user.name "guogy"
## 换成你的 email
git config --global user.email "devguogy@gmail.com"
## 默认 main 分支
## 最早的默认分支都是 master，由于政治正确，GitHub 的默认分支改为了 main
git config --global init.defaultBranch main

配置检查
配置完成后，可以使用以下命令检查配置是否正确：
git config --list

二、GitHub 绑定本地 SSH#

协议选择
你可以选择使用 HTTPS 或 SSH 协议：
HTTPS：需要每次输入用户名和密码
SSH：配置一次后无需重复验证，推荐使用

1. 生成 SSH-Key#

在 Git 命令行输入以下命令，在个人文件夹生成 SSH 密钥：

## 换成你的 email
ssh-keygen -t rsa -C "devguogy@gmail.com"

密钥生成
按回车接受默认文件位置
建议设置一个安全的密码
密钥会保存在 ~/.ssh 目录下

2. GitHub 配置 SSH 公钥#

配置步骤
访问 GitHub SSH Keys 设置页面
点击 “New SSH key”
填写标题（随意）
将 id_rsa.pub 文件内容复制到 Key 输入框

三、Git 项目初始化#

1. 本地仓库初始化#

cd project_dir
git init

初始化检查
初始化后，检查是否生成了 .git 文件夹：
ls -la

2. 远程仓库配置#

仓库创建
在 GitHub 创建新仓库时：
建议不要默认生成 README.md
可以在本地创建后再上传
避免远程和本地 README 不同步的问题

3. 添加远程仓库#

## SSH 协议
git remote add origin git@github.com:***/***.git

## HTTPS 协议
git remote add origin https://github.com/***/***.git

四、Git 提交工作流#

提交流程
标准的 Git 提交流程包含以下步骤：
添加更改
查看状态
创建提交
推送到远程

1. 添加更改#

## 添加所有文件
git add .

## 添加特定文件
git add file/dir

.gitignore
使用 .gitignore 文件来忽略不需要版本控制的文件：
# 示例 .gitignore
node_modules/
.DS_Store
*.log

2. 查看状态#

git status

3. 创建提交#

git commit -m "提交描述"

提交信息规范
好的提交信息应该：
简明扼要
使用现在时态
说明更改的目的

4. 推送到远程#

git push

推送冲突
如果遇到推送错误：
先执行 git pull 同步远程更改
解决可能的冲突
再次尝试推送

五、Git 分支管理#

分支策略
推荐的分支管理策略：
main：主分支，保持稳定
develop：开发分支
feature/*：功能分支
hotfix/*：紧急修复分支

常用分支命令#

## 创建分支
git branch branch_name

## 切换分支
git checkout branch_name

## 查看分支
git branch

## 推送新分支
git push -u origin branch_name

分支操作
切换分支前确保当前分支的更改已提交
新分支首次推送需要使用 -u 参数
分支合并前建议先更新主分支

六、Git 协作流程#

团队协作
有效的团队协作需要：
定期同步远程更改
及时解决冲突
保持提交历史的清晰

1. 获取远程更新#

git pull

2. 解决冲突#

冲突处理
遇到冲突时：
查看冲突文件
手动解决冲突
添加解决后的文件
提交更改

3. 代码审查#

代码审查
建议在合并前：
进行代码审查
运行测试
确保代码质量

七、Git 高级技巧#

1. 暂存更改#

## 暂存当前更改
git stash

## 恢复暂存的更改
git stash pop

2. 撤销更改#

## 撤销工作区更改
git checkout -- file

## 撤销暂存区更改
git reset HEAD file

3. 查看历史#

## 查看提交历史
git log

## 查看文件更改历史
git log -p file

版本回退
谨慎使用版本回退：
确保备份重要更改
避免强制推送
记录回退原因