本文档介绍了 Git 本地与远程仓库（如 GitHub）的同步操作流程。涵盖前提条件配置、创建克隆仓库、拉取更新及推送修改的基本步骤。详细解析了三种下拉冲突处理方案（提交后拉取、暂存后拉取、放弃更改），以及合并冲突和推送冲突的解决方法。此外还包括进阶技巧如 fetch+merge 分步同步、多分支管理及常用命令查看状态历史。最后提供了常见问题解决方案及团队协作的最佳实践建议，旨在帮助用户高效管理版本控制并避免数据丢失。
Git 是现代软件开发中广泛使用的版本控制工具，而 GitHub、Gitee 等平台则是流行的远程仓库托管服务。理解如何在本地与远程仓库之间进行高效的同步操作，对于个人项目管理和团队协作都至关重要。
本文档主要以 GitHub 为例进行说明，但所有操作方法同样适用于 Gitee（码云）等其他 Git 托管平台。
如果您还没有安装配置 Git，请先了解 Git 的安装、配置和基础操作。
在开始之前，请确保你已具备以下条件：
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
如果你还没有远程仓库，首先在 GitHub 上创建：
首次使用远程仓库时，使用 git clone 命令将其克隆到本地：
HTTPS 方式：
git clone https://github.com/用户名/仓库名.git
SSH 方式（推荐）：
git clone [email protected]:用户名/仓库名.git
如果你有现有的本地项目需要关联到新的远程仓库：
# 初始化本地仓库（如果还没有）
git init
# 添加远程仓库
git remote add origin https://github.com/用户名/仓库名.git
确认当前仓库的远程源：
git remote -v
输出示例：
origin https://github.com/用户名/仓库名.git (fetch)
origin https://github.com/用户名/仓库名.git (push)
将 GitHub 仓库同步到本地可以通过以下几种方式实现，具体取决于您的具体需求和安全考虑。
方法 1：常规更新（推荐）
在开始开发前，建议先拉取远程的最新代码：
git pull origin main
注意： 某些仓库的主分支可能叫
master，需根据实际情况替换。
方法 2：强制同步到远程版本
⚠️ 警告：此操作会覆盖本地所有未提交的更改，请谨慎使用！
git fetch --all
# 获取所有更新
git reset --hard origin/main
# 强制重置到远程 main 分支
验证同步状态：
git status
# 检查工作区状态
git log --oneline -5
# 查看最近 5 次提交记录
如果显示'Your branch is up to date with 'origin/main'.'，表示本地与远程仓库已成功同步。
提示： 关于分支切换和冲突处理的详细内容，请参考第 4 节和第 5 节。
步骤 1：添加更改
git add .
# 添加所有更改
# 或
git add 文件名
# 添加特定文件
步骤 2：提交更改
git commit -m "描述你的修改"
步骤 3：推送更改
git push origin main
# 首次推送
# 或
git push
# 后续推送（如已设置 upstream）
首次推送设置 upstream：
git push -u origin main
当远程仓库和本地仓库都发生更改时，Git 操作可能会提示冲突。这里详细介绍下拉冲突和推送冲突的处理方法。
当执行 git pull 时，如果本地有未提交的更改且与远程更改冲突，会出现以下错误：
error: Your local changes to the following files would be overwritten by merge: 文件名
Please commit your changes or stash them before you merge.
Aborting
解决方案有三种：
# 1. 添加所有更改到暂存区
git add .
# 2. 提交更改
git commit -m "描述你的修改"
# 3. 拉取远程更新
git pull origin main
特点：
# 1. 暂存当前更改
git stash
# 2. 拉取远程更新
git pull origin main
# 3. 恢复暂存的更改
git stash pop
特点：
方法 A：使用 git reset --hard（传统方法）
# 1. 放弃所有本地更改
git reset --hard HEAD
# 2. 拉取远程更新
git pull origin main
方法 B：使用 git restore（Git 2.23+，推荐）
# 1. 放弃工作区的所有更改
git restore .
# 2. 拉取远程更新
git pull origin main
git restore 的其他用法：
# 恢复特定文件
git restore 文件名
# 恢复暂存区的文件到工作区
git restore --staged 文件名
# 恢复文件到指定提交版本
git restore --source=HEAD~1 文件名
特点：
git restore 比 git reset --hard 更安全，语义更清晰当远程和本地修改了相同文件的相同部分时，会产生合并冲突：
冲突解决流程：
git pull origin main
# 如果提示冲突，Git 会自动标记冲突文件
git status
# 会显示哪些文件有冲突
打开方式：
code 文件名（VS Code）或 notepad 文件名（记事本）冲突标记格式：
<<<<<<< HEAD
你的本地更改内容
=======
远程仓库的更改内容
>>>>>>> origin/main
VS Code 冲突解决示例： VS Code 会在冲突文件中显示可点击的选项：
Accept Current Change（接受当前更改）Accept Incoming Change（接受传入更改）Accept Both Changes（接受两个更改）Compare Changes（比较更改）<<<<<<<、=======、>>>>>>>）git add .
git commit -m "解决合并冲突"
当推送时远程仓库有新的提交，会出现 non-fast-forward 错误：
错误信息示例：
! [rejected] main -> main (non-fast-forward)
error: failed to push some refs to 'origin'
hint: Updates were rejected because the tip of your current branch is behind
解决方法：
git pull origin main
# 先拉取远程更新
git push origin main
# 再推送本地更改
git pull --rebase origin main
# 变基合并
git push origin main
git push --force origin main
# 强制覆盖远程仓库
⚠️ 警告： 强制推送会覆盖远程更改，可能导致其他人的工作丢失！
fetch + merge 分步同步git fetch origin
# 获取远程更新但不合并
git merge origin/main
# 手动合并
这种方式适合需要在合并前检查远程更改的场景。
查看所有分支：
git branch -a
# 查看所有分支（包括远程）
切换并同步其他分支：
git checkout dev
# 切换到 dev 分支
git pull origin dev
# 拉取 dev 分支的更新
创建并推送新分支：
git checkout -b feature-branch
# 创建并切换到新分支
git push -u origin feature-branch
# 推送新分支到远程
批量更新多个分支：
git fetch --all
# 获取所有远程分支更新
git branch -r
# 查看远程分支列表
查看当前状态：
git status
查看提交历史：
git log
# 详细历史
git log --oneline
# 简洁历史
设置默认合并工具：
# 设置 VS Code 为默认合并工具
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait $MERGED'
使用合并工具解决冲突：
git mergetool
# 自动启动配置的合并工具
查看当前配置：
git config --list | grep merge
问题 1：认证失败
解决方法：
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
问题 2：无法连接到 GitHub
解决方法：
问题 3：忘记添加远程仓库
解决方法：
git remote add origin https://github.com/用户名/仓库名.git
问题 4：分支不同步
解决方法：
git pull origin main
# 拉取最新更改
问题 5：想要回退到特定提交
解决方法：
git log
# 查看提交历史，找到目标提交 ID
git reset --hard 提交 ID
# 硬重置到指定提交
git push --force origin main
# 强制推送（谨慎使用）
问题 6：如何撤销工作区的修改
解决方法：
# 撤销所有工作区修改（Git 2.23+）
git restore .
# 撤销特定文件的修改
git restore 文件名
# 撤销暂存区的修改（取消 add）
git restore --staged 文件名
# 传统方法（适用于所有 Git 版本）
git checkout -- 文件名
git reset HEAD 文件名
# 取消暂存
🔄 同步习惯
git pull - 获取最新远程更改git status - 了解当前工作区状态📝 提交规范
🔐 安全建议
--force、--hard 等👥 团队协作
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 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