Cursor 连接 GitHub 已有仓库的 Git 操作指南
当本地已经有一个项目，而 GitHub 上也有一个同名或同路径的仓库时，直接 push 往往会报错。这时候我们需要把本地仓库和远程仓库关联起来，并处理好两边的历史记录冲突。下面以 Cursor 为例，讲讲怎么顺畅地完成这个流程。
初始化与远程连接
先在 Cursor 内置终端里检查一下当前的状态：
git remote -v
如果没输出，说明还没连上远程。接下来添加远程地址，把本地的 origin 指向你的 GitHub 仓库：
git remote add origin https://github.com/你的用户名/你的仓库名.git
为了统一分支命名规范，建议把主分支重命名为 main：
git branch -M main
处理历史冲突
这是最关键的一步。因为本地是新建的仓库，GitHub 上的仓库可能已经有提交记录，两边历史互不相干。直接 pull 会失败，需要加上参数允许合并无关历史：
git pull origin main --allow-unrelated-histories
运行后通常会触发冲突。回到 Cursor 的项目界面，找到冲突文件，用内置的合并编辑器解析。系统会提示你选择保留传入的内容还是当前的内容，根据实际业务需求勾选即可。确认无误后点击右上角的对号保存。
合并与提交推送
冲突解决完，就可以准备提交了。在左侧文件栏选中修改过的文件，点击加号图标暂存到索引区。
接着在消息框输入本次提交的说明，比如'修复冲突并同步代码'。确认好要提交的文件列表后，点击提交按钮。最后点击推送图标，将本地更改推送到 GitHub。
推送到 GitHub 检查是否成功，刷新网页就能看到最新的提交记录了。整个过程走一遍就熟悉了，以后遇到类似情况也能快速上手。