qoder多人协作中git分支管理需与实时机制对齐：一、创建切换分支并绑定workspace上下文；二、设置上游追踪并推送；三、通过qoder界面安全合并，含冲突检测；四、清理已合并分支并更新引用；五、启用分支感知同步防编辑错位。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 进行多人协作开发时，发现代码变更无法按预期隔离、合并失败、分支状态混乱或本地修改被意外覆盖，则可能是由于 Git 分支管理未与 Qoder 的实时协作机制对齐。以下是解决此问题的步骤：
一、在 Qoder 中创建并切换 Git 分支
Qoder 支持通过内置终端或图形化操作创建和切换分支，确保每个功能开发或 Bug 修复在独立分支中进行，避免污染主干。分支创建需同步触发 Qoder 的 Workspace 环境感知，使后续编辑行为自动绑定至当前分支上下文。
1、在 Qoder 编辑器底部状态栏点击当前分支名称（如 main），弹出分支选择面板。
2、点击「新建分支」按钮，输入新分支名（例如 feat/user-auth-flow），并选择基于当前提交创建。
3、确认后，Qoder 自动执行 git checkout -b feat/user-auth-flow，并在左侧资源管理器顶部显示当前分支标识。
4、所有后续文件保存、编辑操作均默认归属于该分支，且变更暂存区与 Qoder 的 ShareDB 同步层自动关联。
二、启用分支追踪与远程同步
Qoder 要求本地分支明确建立上游追踪关系，否则 push 操作将失败，且协作界面无法识别分支归属，导致其他协作者无法加载对应历史快照。
1、打开 Qoder 内置终端（Ctrl+`），确保位于项目根目录。
2、执行命令：git branch --set-upstream-to=origin/feat/user-auth-flow feat/user-auth-flow，将本地分支与远程同名分支绑定。
3、运行 git branch -vv 验证输出中是否包含 [origin/feat/user-auth-flow] 字样。
4、在 Qoder 右键项目根目录 →「Git」→「Push Branch」，首次推送将自动创建远程分支并启用保护规则同步。
三、在 Qoder 中执行安全分支合并
Qoder 的合并操作不仅调用 Git 命令，还会触发预合并检查：包括冲突检测、CI 流水线状态读取、以及协作会话中未提交编辑的强制暂存。若跳过该流程直接使用 CLI 合并，可能导致实时编辑状态丢失。
1、切换回目标接收分支（如 main）：点击底部状态栏分支名 → 选择 main。
Git 提交信息生成器。根据代码变更内容自动生成符合 Conventional Commits 规范的提交信息，包含类型、范围、简短描述、详细说明和关联的 Issue/需求号。触发词：生成提交信息、提交信息、commit message、git commit、生成 commit 信息
2、右键项目根目录 →「Git」→「Merge Branch」→ 选择待合入分支 feat/user-auth-flow。
3、Qoder 自动拉取最新远程 main 并执行三方合并（git merge --no-ff），生成合并提交对象。
4、若检测到冲突，Qoder 在编辑器中高亮冲突块，并禁用保存按钮，直至用户通过内联编辑器手动解决并标记为已解决。
四、清理已合并分支并更新本地引用
Qoder 默认不自动删除已合并分支，需显式执行清理操作以维持分支列表简洁；同时必须更新本地远程跟踪引用，防止后续 fetch 拉取过期分支信息干扰协作状态。
1、完成合并后，在 Qoder 底部状态栏右键当前分支名 →「Prune Remote Branches」，清除本地已不存在的远程分支引用。
2、右键项目根目录 →「Git」→「Delete Local Branch」→ 选择 feat/user-auth-flow，勾选「仅当已合并至当前分支」校验项。
3、执行 git fetch --prune 更新远程分支列表，Qoder 状态栏将实时刷新可用分支下拉选项。
4、验证：运行 git branch -r | grep user-auth-flow，应无任何输出。
五、处理跨分支编辑冲突与光标错位
当多个协作者分别在不同分支上编辑同一文件，且未及时合并或同步时，Qoder 的 OT（Operational Transformation）引擎可能因分支上下文缺失而无法正确映射操作序列，导致光标漂移、内容覆盖或编辑延迟。
1、在 Qoder 设置中搜索 git.branchAwareSync，将其值设为 true，强制启用分支感知同步模式。
2、打开项目根目录下的 .qoder/config.json，添加字段："syncScope": "branch"。
3、重启 Qoder 编辑器，重新加载 Workspace，确保 ShareDB 适配层加载当前分支 HEAD 的 commit hash 作为操作锚点。
4、若仍出现错位，执行 qoder sync reset --hard 清除本地 Git 操作缓存与 ShareDB 本地操作日志，重建同步状态。
