本文整理了 Git 版本控制的核心操作流程，涵盖首次克隆远程仓库、本地更新代码、提交推送规范及分支管理。内容包含常用命令速查表、冲突处理方案及避坑指南，帮助开发者掌握 git clone、pull、add、commit、push 等关键指令，提升协作效率。
作为开发者，Git 是日常工作中绕不开的版本控制工具 —— 从协作开发拉取最新代码，到提交自己的开发成果，再到处理分支、回滚代码等场景，熟练掌握核心命令能大幅提升开发效率。本文整理了 Git 最核心的「拉取代码、提交代码」流程，以及日常工作中高频使用的命令，既是新手入门指南，也可作为老开发者的速查手册。
拉取代码分为两种场景：首次克隆远程仓库、本地已有项目拉取最新更新，对应不同的命令和操作逻辑。
如果是第一次获取项目代码，使用 git clone 命令将远程仓库完整克隆到本地，步骤如下：
# 1. 打开终端，进入要存放代码的目录（比如~/projects）
~/projects
git https://github.com/用户名/仓库名.git
git [email protected]:用户名/仓库名.git
仓库名
git init
关键说明：
origin）；如果需要克隆指定分支（而非默认 main/master），添加 -b 参数：
git clone -b 分支名 https://github.com/用户名/仓库名.git
日常开发中，每次开始工作前都需要拉取远程最新代码（避免和同事的代码冲突），核心命令是 git pull：
# 1. 先进入项目目录
cd 你的项目目录
# 2. 拉取当前分支的远程最新代码（最简单方式）
git pull
# 进阶：指定远程仓库和分支（适用于关联多个远程仓库的场景）
git pull origin 分支名
# 比如 git pull origin develop
避坑提示：
git status 查看本地是否有未提交的修改，若有未提交内容，拉取可能触发冲突；提交代码不是一步到位，而是遵循「暂存→提交→推送」的流程，确保代码可追溯、版本清晰。
# 首次配置即可
# 配置全局用户名（可以是你的昵称/真实姓名，比如 "xiaoming"）
git config --global user.name "你的名字"
# 配置全局邮箱（建议用你注册 Git 仓库平台的邮箱，如 Gitee/GitHub/GitLab 邮箱）
git config --global user.email "你的邮箱@example.com"
# 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 status | 查看本地代码修改状态（哪些文件新增 / 修改 / 删除） | git status |
git log | 查看提交历史（按时间倒序） | git log（简洁版：git log --oneline） |
git branch | 查看本地分支（* 标注当前分支） | git branch（查看远程分支：git branch -r） |
git remote -v | 查看本地关联的远程仓库地址 | git remote -v |
# 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
# 合并指定分支
# 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
# 谨慎使用！会清空本地未提交的修改
# 1. 关联远程仓库（本地初始化仓库后使用）
git remote add origin 远程仓库地址
# 比如 git remote add origin [email protected]:xxx/xxx.git
# 2. 查看远程分支最新状态（不拉取代码，仅同步分支信息）
git fetch origin
# 3. 删除远程分支（比如删除已合并的 feature 分支）
git push origin --delete 分支名
git status：防止提交无关文件（比如 IDE 配置文件、本地测试文件）；拉取代码前先提交本地修改：或使用 git stash 暂存修改（拉取后再恢复）：
# 暂存本地修改
git stash
# 拉取远程代码
git pull
# 恢复暂存的修改
git stash pop
Git 的核心价值是「版本控制 + 协作开发」，日常使用无需死记所有命令，重点掌握：
git clone（首次）/git pull（更新）；git add → git commit → git push；git checkout -b（新建分支）、git merge（合并分支）；git status、git checkout --、git reset。熟练掌握这些核心操作，再结合本文的速查命令，就能应对 90% 以上的日常开发场景。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online