git使用说明

Git 完整使用说明书（标准版·全场景覆盖）

一、Git 核心原理（必懂）

Git 分为四个工作区域，所有命令都是围绕这四个区域流转：

1. 工作区：本地实际编辑的代码文件

2. 暂存区（Stage）：临时存放待提交的文件（git add 后进入）

3. 本地仓库：本地永久保存的版本快照（git commit 后进入）

4. 远程仓库：云端仓库（Gitee/GitHub/GitLab）

标准工作流：工作区修改 → add暂存 → commit本地提交 → push远程推送

二、首次安装全局配置（仅执行一次）

配置提交用户名和邮箱，用于记录代码作者信息

# 配置全局用户名
git config --global user.name "你的用户名"

# 配置全局邮箱
git config --global user.email "你的邮箱@xxx.com"

# 查看所有全局配置
git config --global --list

# 设置默认推送策略（兼容新版Git）
git config --global push.default simple

三、仓库初始化与克隆

3.1 本地新建 Git 仓库

# 将当前文件夹初始化为Git仓库
git init

3.2 克隆远程仓库到本地

# HTTPS 方式（无需配置密钥，简单）
git clone https://gitee.com/xxx/xxx.git

# SSH 方式（推荐，配置密钥后免密码推送）
git clone git@gitee.com:xxx/xxx.git

四、日常核心基础命令（90% 开发场景）

4.1 查看文件状态

# 查看文件改动状态（红色未暂存、绿色已暂存）
git status

# 简洁版状态展示
git status -s

4.2 暂存文件（提交前必备）

# 暂存单个指定文件
git add 文件名.后缀

# 暂存所有改动（新增/修改/删除文件，最常用）
git add .

# 暂存当前文件夹所有改动（等价 git add .）
git add *

4.3 本地提交代码

# 提交所有暂存文件，必须填写提交备注
git commit -m "feat: 新增xxx功能/优化xxx逻辑"

4.4 推送代码到远程仓库

# 推送到指定远程分支
git push origin 分支名

# 示例：推送到主分支
git push origin main

4.5 拉取远程最新代码

# 拉取远程分支最新代码并合并到本地
git pull origin main

五、版本日志查看

# 查看完整提交日志（详细信息）
git log

# 极简单行日志（推荐日常使用）
git log --oneline

# 树形可视化日志（查看分支流转）
git log --oneline --graph --all

# 查看所有操作记录（回退、重置、合并均可查到，用于找回版本）
git reflog

六、分支管理（Git 核心功能）

6.1 查看分支

# 查看本地所有分支
git branch

# 查看远程所有分支
git branch -r

# 查看本地+远程所有分支
git branch -a

6.2 创建 & 切换分支

# 仅创建分支
git branch 分支名

# 切换到指定分支
git checkout 分支名

# 【最常用】创建并直接切换到新分支
git checkout -b feature/新功能名

# 新版Git 切换分支写法
git switch 分支名
git switch -c 新分支名

6.3 重命名分支

# 重命名当前所在分支
git branch -m 新分支名

6.4 删除分支

# 安全删除本地分支（已合并才可删除）
git branch -d 分支名

# 强制删除本地分支（未合并也可删除）
git branch -D 分支名

# 删除远程分支
git push origin --delete 分支名

七、代码合并与冲突解决

7.1 分支合并（普通合并）

# 1. 切换到需要被合并的主分支
git checkout main

# 2. 将开发分支代码合并到主分支
git merge feature/xxx

# 3. 推送合并后的代码到远程
git push origin main

7.2 冲突解决方法

合并代码出现冲突时，打开冲突文件，删除 <<< HEAD / ===== / >>> 标记，保留最终代码，然后执行：

# 解决冲突后重新暂存、提交、推送
git add .
git commit -m "fix: 解决代码合并冲突"
git push origin main

八、代码撤销与版本回退（救命命令）

场景1：工作区修改，未add，撤销所有修改

# 撤销所有未暂存修改，恢复为原版
git checkout .

场景2：已add暂存，未commit，撤销暂存

# 撤销暂存，代码保留
git reset HEAD .

场景3：已commit，需要撤回本次提交

# 软回退：撤回提交，代码保留在本地（推荐）
git reset --soft HEAD~1

# 硬回退：撤回提交，代码彻底恢复原样（慎用！不可逆）
git reset --hard HEAD~1

场景4：回退到指定历史版本

# 1. git reflog 查看历史commit-id
# 2. 硬回退到指定版本
git reset --hard 目标commit-id

九、远程仓库关联管理

9.1 关联远程仓库

git remote add origin 远程仓库地址

9.2 查看远程仓库信息

git remote -v

9.3 修改远程仓库地址

git remote set-url origin 新仓库地址

9.4 解绑远程仓库

git remote remove origin

十、忽略文件配置 .gitignore

项目根目录新建.gitignore 文件，配置无需提交的文件/文件夹

# 系统文件
.DS_Store
*.tmp
*.log

# 算法/Matlab项目专属
*.mat
*.fig
outputs/
build/

# Python项目专属
__pycache__/
*.pyc
.ipynb_checkpoints/

# 编译产物
*.exe
*.dll

十一、Tag 版本标签管理（发布版本用）

# 查看所有标签
git tag

# 创建轻量标签
git tag v1.0.0

# 创建带备注标签
git tag -a v1.0.0 -m "正式版v1.0.0发布"

# 推送单个标签到远程
git push origin v1.0.0

# 推送所有标签
git push origin --tags

# 删除本地标签
git tag -d v1.0.0

# 删除远程标签
git push origin --delete tag v1.0.0

十二、高阶实用命令

12.1 代码暂存（临时保存改动）

临时切分支，不想提交当前改动，使用 stash 暂存

# 暂存所有本地改动
git stash

# 查看暂存记录
git stash list

# 恢复最近一次暂存
git stash pop

# 清空所有暂存记录
git stash clear

12.2 变基合并（整洁提交记录）

# 变基当前分支到主分支
git rebase main

十三、规范提交注释（企业通用）

• feat：新增功能

• fix：修复 bug

• optimize：代码优化、性能优化

• docs：文档修改

• refactor：代码重构（无功能变动）

• test：新增测试代码

示例：git commit -m "feat: 新增TEMP_M_TEST_MODE测试模式"

十四、常见问题解决

14.1 推送报错：本地与远程版本不一致

# 先拉取远程最新代码，再推送
git pull origin main
git push origin main

14.2 忘记拉代码导致冲突

手动解决冲突后，重新 add、commit、push 即可

14.3 清空当前所有改动

git reset --hard HEAD && git clean -df