需启用Git插件、绑定远程仓库、开启自动提交、配置ShareDB双模同步并显式设为协同项目，否则编辑不实时、状态不同步、光标错位。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在Qoder中新建了一个多人协作项目，但发现队友修改的代码在你本地不显示、任务状态不同步、甚至编辑同一行时出现覆盖或光标错位——这不是网络问题，而是协作开发模式未正确激活或同步策略未对齐。
启用Git插件并绑定远程仓库
Qoder实时协作依赖Git提交作为变更锚点，若插件未启用或远程地址错误，所有本地编辑都不会进入协作上下文。
1、打开Qoder左侧边栏「扩展」→搜索“Git Integration”→确认状态为“已启用”，未安装则先安装并重启编辑器。
2、在项目根目录终端执行 【git remote get-url origin】，验证输出是否为真实的GitHub/Gitee SSH或HTTPS地址。若为空或显示file://，说明尚未关联远程仓库。
3、执行 【git remote add origin git@github.com:yourname/yourrepo.git】（替换为你的真实仓库地址），再运行git push -u origin main完成首次推送。
开启自动提交与分支追踪
这一步决定你的每一次保存是否能被队友实时感知。Qoder默认不自动提交，必须显式开启，否则编辑行为仅停留在工作区，不会触发同步广播。
方法一：设置自动提交
进入Qoder设置页→搜索“git.autoCommit”→将值设为true。
方法二：强制建立分支追踪
在终端执行 【git branch -u origin/main】（若主干是master则替换为master），确保当前分支与远程同名分支建立上游关系。若提示“no upstream configured”，说明追踪未生效，后续push会失败。
验证方式：运行git branch -vv，当前分支后应显示[origin/main]字样，缺此项则同步链路断裂。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
配置ShareDB适配层启用双模同步
Git只管版本快照，而实时协同需要操作级收敛。ShareDB是Qoder实现OT（操作变换）冲突消解的底层协议，必须通过配置文件显式启用，否则多人编辑将退化为“最后保存者胜出”的覆盖模式。
1、在项目根目录创建.qoder/config.json文件（若不存在）。
2、写入以下内容：
{ "syncMode": "git-sharedb", "sharedb": { "enabled": true, "docIdPrefix": "file:" } }
3、保存后重启Qoder编辑器——此配置不可热更新，必须重启才生效。
注意：若跳过此步，即使Git提交成功，队友也无法看到你逐字输入的过程，只能等到你提交后刷新才看到整块变更。
将项目设为协同项目并验证同步状态
Qoder采用显式注册机制，不是所有项目都默认参与云端协同。只有标记为“协同项目”的文件夹，其代码变更、任务日志、Spec文档才会上传至Qoder开放平台供多端拉取。
第一步：右键项目文件夹→选择“设为协同项目”。
第二步：确认路径为纯英文、无空格、无中文（如feishu-backend），否则同步服务会直接拒绝注册。
第三步：在桌面端状态栏右下角点击云图标→选择“Sync: Push”，强制将当前项目元数据与最新提交推送到云端。
第四步：让队友在自己设备上打开同一项目→等待左下角出现“正在从云端加载协同上下文…”提示→待提示消失后，双方同时修改同一函数名，观察是否实时互见变更。
