Git 核心操作指南：拉取、提交与高频命令速查

完整提交流程（4 步走）

# 1. 查看本地代码修改状态（必做！确认要提交的文件）
git status

# 2. 将修改的文件加入暂存区（核心：指定要提交的文件）
# 方式 1：提交所有修改的文件（新增/修改/删除）
git add .

# 方式 2：提交指定文件（推荐，避免提交无关文件）
git add 文件名 1 文件名 2
# 比如 git add src/main.py config.yaml

# 3. 将暂存区的文件提交到本地仓库（必须写提交信息，规范！）
git commit -m "提交信息：清晰描述做了什么修改"
# 示例：git commit -m "feat: 新增用户登录接口的测试用例"

# 4. 关联远程仓库（首次推必做）
git remote add origin [email protected]:你的用户名/仓库名.git

# 5. 首次推送（绑定分支）
git push -u origin 分支名

# 6. 后续推送只需执行（不用写地址/分支）
git push

# 进阶：指定远程仓库和分支（适用于多远程/多分支场景）
git push origin 分支名
# 比如 git push origin feature/user-login 

提交规范（团队协作必备）

提交信息建议遵循「类型：描述」的格式，便于后续追溯和自动化生成日志，常见类型：

• feat：新增功能（比如 feat: 新增订单查询接口）；
• fix：修复 bug（比如 fix: 修复登录时验证码失效的问题）；
• docs：仅修改文档（比如 docs: 更新 README.md）；
• style：代码格式调整（无逻辑修改，比如缩进、空格）；
• refactor：代码重构（无新增功能 / 修复 bug）；
• test：新增 / 修改测试代码；
• chore：构建 / 工具配置修改（比如 chore: 升级依赖版本）。

常见问题处理

推送到远程后发现错误（需撤回推送）：谨慎使用，避免覆盖团队代码！

# 回滚本地提交（保留代码修改，仅撤销 commit）
git reset --soft HEAD^

提交后发现漏加文件 / 提交信息写错：

# 补充文件并合并到上一次提交（保留原提交记录，仅修改内容）
git add 漏加的文件名
git commit --amend --no-edit
# --no-edit 表示不修改提交信息
# 若需要修改提交信息，去掉--no-edit，手动输入新信息
git commit --amend 

git push 失败：出现相关报错 hint: use 'git pull' before pushing again. （原因：远程仓库的 mall-admin-web 分支有本地没有的提交记录）

# 解决步骤：执行这条命令后再重新提交
git pull origin mall-admin-web --allow-unrelated-histories --no-rebase
# --allow-unrelated-histories：解决本地 / 远程分支'无共同提交历史'的核心参数；
# --no-rebase：用最简单的 merge 方式合并，避免新手容易出错的 rebase 操作。

三、日常高频 Git 命令速查（分类整理）

1. 仓库 / 状态查看类（最常用）

2. 分支操作类（协作开发核心）

# 1. 创建并切换到新分支（日常开发必用，避免直接改主分支）
git checkout -b 新分支名
# 比如 git checkout -b feature/order-query

# 2. 切换到已有分支
git checkout 分支名
# 比如 git checkout develop

# 3. 删除本地分支（开发完成后清理）
git branch -d 分支名
# 强制删除未合并的分支：git branch -D 分支名

# 4. 合并分支（比如将 feature 分支合并到 develop）
git checkout develop
# 先切换到目标分支
git merge feature/order-query
# 合并指定分支 

3. 代码撤销 / 回滚类（救急必备）

# 1. 撤销工作区的修改（未 add 的文件，恢复到最近一次 commit 状态）
git checkout -- 文件名
# 比如 git checkout -- src/main.py

# 2. 撤销暂存区的文件（已 add 但未 commit）
git reset HEAD 文件名
# 撤销指定文件；撤销所有：git reset HEAD .

# 3. 回滚到指定版本（根据 commit ID，可从 git log 获取）
git reset --hard 提交 ID
# 谨慎使用！会清空本地未提交的修改 

4. 远程仓库操作类

# 1. 关联远程仓库（本地初始化仓库后使用）
git remote add origin 远程仓库地址
# 比如 git remote add origin [email protected]:xxx/xxx.git

# 2. 查看远程分支最新状态（不拉取代码，仅同步分支信息）
git fetch origin

# 3. 删除远程分支（比如删除已合并的 feature 分支）
git push origin --delete 分支名 

四、日常使用避坑指南

1. 避免直接在主分支（main/master）开发：始终创建 feature 分支开发，合并前先拉取主分支最新代码，减少冲突；
2. 提交前必看 git status：防止提交无关文件（比如 IDE 配置文件、本地测试文件）；
3. 冲突处理优先沟通：遇到代码冲突时，先和修改该部分代码的同事确认，避免盲目覆盖。

拉取代码前先提交本地修改：或使用 git stash 暂存修改（拉取后再恢复）：

# 暂存本地修改
git stash

# 拉取远程代码
git pull

# 恢复暂存的修改
git stash pop 

五、总结

Git 的核心价值是「版本控制 + 协作开发」，日常使用无需死记所有命令，重点掌握：

1. 拉取代码：git clone（首次）/git pull（更新）；
2. 提交代码：git add → git commit → git push；
3. 分支管理：git checkout -b（新建分支）、git merge（合并分支）；
4. 状态查看 / 撤销：git status、git checkout --、git reset。

熟练掌握这些核心操作，再结合本文的速查命令，就能应对 90% 以上的日常开发场景。