编辑“︁Git远程仓库同步”︁

= Git远程仓库同步 =

== 介绍 ==  
'''Git远程仓库同步'''是指将本地Git仓库的更改与远程仓库（如GitHub、GitLab或Bitbucket）进行双向更新的过程。这一操作是团队协作和版本控制的核心，确保所有开发者都能访问最新的代码版本。同步通常涉及以下关键操作：  
* '''推送（Push）'''：将本地提交上传到远程仓库  
* '''拉取（Pull）'''：将远程仓库的更改合并到本地  
* '''获取（Fetch）'''：查看远程仓库的更改但不自动合并  

== 基本操作 ==  

=== 查看远程仓库 ===  
使用以下命令查看当前配置的远程仓库：  
<syntaxhighlight lang="bash">  
git remote -v  
</syntaxhighlight>  
输出示例：  
<pre>  
origin  https://github.com/user/repo.git (fetch)  
origin  https://github.com/user/repo.git (push)  
</pre>  

=== 推送更改（Push） ===  
将本地分支的提交推送到远程仓库：  
<syntaxhighlight lang="bash">  
git push origin main  
</syntaxhighlight>  
* <code>origin</code>：远程仓库别名  
* <code>main</code>：目标分支  

=== 拉取更改（Pull） ===  
拉取远程分支并自动合并到本地：  
<syntaxhighlight lang="bash">  
git pull origin main  
</syntaxhighlight>  
等价于以下两条命令的组合：  
<syntaxhighlight lang="bash">  
git fetch origin  
git merge origin/main  
</syntaxhighlight>  

=== 解决冲突 ===  
当远程和本地修改同一文件的同一部分时，需手动解决冲突。冲突标记如下：  
<syntaxhighlight lang="text">  
<<<<<<< HEAD  
本地更改  
=======  
远程更改  
>>>>>>> commit-hash  
</syntaxhighlight>  

== 高级操作 ==  

=== 强制推送 ===  
谨慎使用！会覆盖远程历史记录：  
<syntaxhighlight lang="bash">  
git push --force origin main  
</syntaxhighlight>  

=== 跟踪远程分支 ===  
创建本地分支并关联远程分支：  
<syntaxhighlight lang="bash">  
git checkout --track origin/feature  
</syntaxhighlight>  

== 工作流程示例 ==  

<mermaid>  
gitGraph  
    commit  
    branch feature  
    checkout feature  
    commit  
    checkout main  
    merge feature  
    push  
    pull  
</mermaid>  

=== 实际案例 ===  
'''场景'''：团队协作开发时，Alice和Bob同时修改<code>README.md</code>。  
1. Alice推送更改：  
   <syntaxhighlight lang="bash">  
   git push origin main  
   </syntaxhighlight>  
2. Bob尝试推送时被拒绝，需先拉取更新：  
   <syntaxhighlight lang="bash">  
   git pull origin main  
   </syntaxhighlight>  
3. 解决冲突后重新推送。  

== 数学表达 ==  
同步操作可视为集合运算：  
<math>  
\text{远程仓库} = (\text{本地仓库} \cup \text{远程变更}) \setminus \text{冲突部分}  
</math>  

== 最佳实践 ==  
* 频繁拉取以避免大规模冲突  
* 推送前运行<code>git status</code>检查状态  
* 使用<code>--force-with-lease</code>替代<code>--force</code>防止覆盖他人提交  

== 参见 ==  
* [[Git分支管理]]  
* [[Git冲突解决]]  

[[Category:Git学习路径]]  
[[Category:版本控制]]

[[Category:集成部署]]
[[Category:Git]]
[[Category:Git远程操作]]