需配置本地Git并关联GitHub账户，再在Cursor中初始化/克隆仓库、提交推送代码、管理分支，最后启用GitHub Copilot插件增强AI协作能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用 Cursor 进行代码编写时希望与 GitHub 实现无缝协同，例如同步代码、管理分支、提交变更或拉取远程更新，则需完成本地 Git 配置与 GitHub 账户的可信连接。以下是实现 Cursor 与 GitHub 协同开发的具体操作步骤：
一、配置本地 Git 并关联 GitHub 账户
Cursor 本身不内置 Git 客户端，而是调用系统已安装的 Git 命令行工具，因此必须确保本地 Git 已正确安装并完成全局用户信息配置，同时通过 SSH 或 HTTPS 方式与 GitHub 建立认证通道。
1、打开终端（macOS/Linux）或 PowerShell（Windows），执行 git --version 确认 Git 已安装。
2、运行 git config --global user.name "YourGitHubUsername" 设置全局用户名。
3、运行 git config --global user.email "your_email@example.com" 设置全局邮箱，该邮箱须与 GitHub 账户注册邮箱一致。
4、生成 SSH 密钥：执行 ssh-keygen -t ed25519 -C "your_email@example.com"，按回车接受默认路径。
5、将 SSH 密钥添加到 ssh-agent：运行 eval "$(ssh-agent -s)" 后执行 ssh-add ~/.ssh/id_ed25519。
6、复制公钥内容：执行 cat ~/.ssh/id_ed25519.pub | pbcopy（macOS）或 cat ~/.ssh/id_ed25519.pub | clip（Windows）。
7、登录 GitHub → Settings → SSH and GPG keys → New SSH key，粘贴公钥并保存。
二、在 Cursor 中初始化或打开 GitHub 仓库
Cursor 支持直接克隆远程仓库或打开已有本地仓库，其侧边栏集成 Git 图标可触发版本控制面板，所有操作均基于当前工作区根目录下的 .git 文件夹识别为 Git 仓库。
1、点击 Cursor 左侧活动栏中的 源代码管理图标（分支图标），若未显示则说明当前文件夹未初始化为 Git 仓库。
2、若为新项目，先在终端中进入项目目录，执行 git init 初始化本地仓库。
3、点击 Cursor 顶部菜单栏的 File → Open Folder，选择含 .git 文件夹的本地仓库目录。
4、若需克隆远程仓库，点击 File → Clone Repository，输入 GitHub 仓库 HTTPS 或 SSH 地址（如 git@github.com:username/repo.git）。
5、克隆完成后，Cursor 自动加载仓库，并在源代码管理视图中显示未暂存/已暂存的更改文件列表。
三、在 Cursor 中完成提交与推送操作
Cursor 将 Git 提交流程图形化集成于界面，支持暂存单个文件、编辑提交信息、选择分支及一键推送，所有操作最终调用底层 git commit 和 git push 命令。
1、修改代码后，返回源代码管理视图，点击文件名左侧的 + 号 暂存该文件；或点击全部更改上方的 + 全部暂存。
2、在提交信息输入框中键入符合规范的提交描述，例如 feat: add user login validation。
3、点击输入框右上角的 ✓ 提交并推送 按钮（若首次推送需指定上游分支）。
4、若提示“没有上游分支”，点击弹出菜单中的 Push to origin/main（或 origin/master，依远程默认分支而定）。
5、推送成功后，源代码管理视图底部状态栏显示 main（已同步），且 GitHub 仓库网页端可立即查看新提交。
四、在 Cursor 中处理分支与 Pull Request 预备操作
Cursor 支持可视化切换、创建与合并本地分支，并可通过 GitHub CLI 或手动方式为 PR 准备提交，但 PR 创建本身仍需跳转至 GitHub 网页或使用 gh CLI 工具完成。
1、点击 Cursor 底部状态栏中当前分支名称（如 main），在弹出面板中选择 Create new branch。
2、输入新分支名，例如 feature/user-profile-ui，并选择基于的提交（默认为当前 HEAD）。
3、切换至新分支后进行编码，完成后按前述流程提交变更。
4、切换回 main 分支，点击状态栏分支名 → Pull from origin/main 获取最新主干更新。
5、在 feature 分支中执行 git rebase main（需在终端中运行），以线性整合历史，避免合并提交。
6、推送 feature 分支：右键该分支 → Push Branch，勾选 Set upstream。
五、启用 GitHub Copilot 插件增强 Cursor 的 AI 协作能力
Cursor 原生兼容 GitHub Copilot，启用后可在编辑器内实时获得基于 GitHub 公共代码库训练的补全建议，尤其适用于快速生成符合项目风格的函数、测试用例或文档注释。
1、确保已登录 GitHub 账户并开通 Copilot 订阅，在 github.com/settings/copilot 页面确认状态为 Active。
2、在 Cursor 中点击左下角齿轮图标 → Settings → Extensions，搜索 GitHub Copilot 并启用。
3、重启 Cursor，打开任意支持语言的代码文件（如 .py、.js），开始输入函数名或注释，等待右下角出现 Copilot suggestion 提示。
4、按 Tab 接受建议，或按 Ctrl+Enter（Windows/Linux）/ Cmd+Enter（macOS） 查看多条候选。
5、在提交前，可使用命令面板（Ctrl+Shift+P）运行 Copilot: Generate Unit Tests 快速补全测试代码。
