同步失败时需依次检查：1.桌面端「启用云同步」开关是否开启；2.网页端与桌面端是否使用完全相同的账号登录；3.排查代理配置是否阻断同步请求；4.强制触发完整同步；5.清除本地Cache缓存重建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
TRAE Work网页端与桌面端同步失败时，你无法实时看到另一端的编辑内容，协作中断、版本错乱、修改丢失的风险立刻出现，必须立即定位原因并修复。
确认同步开关是否开启
打开桌面端右下角系统托盘图标 → 右键点击 → 选择「设置」→ 进入「同步」选项卡。
检查「启用云同步」开关是否处于开启状态。若为关闭状态，网页端所有操作都不会上传至云端，桌面端也收不到任何更新。
这一步操作起来很简单，直接把开关拨到蓝色即可，无需重启应用。
验证账号登录一致性
网页端和桌面端必须使用【完全相同的账号】登录，包括大小写、邮箱别名（如 gmail.com 的 + 号后缀）、第三方登录绑定关系。
常见错误：网页端用 GitHub 账号登录，桌面端却用邮箱密码登录——二者在 TRAE 系统中视为两个独立账户，数据完全隔离。
解决方法：桌面端点击左上角头像 → 「退出登录」→ 重新用网页端正在使用的同一方式登录。
排查网络代理配置冲突
方法一：检查桌面端是否误启代理
进入桌面端「设置」→「通用」→「编辑器设置」→ 搜索“Proxy” → 查看「Http: Proxy」字段是否填写了地址。
若该字段非空，请确认代理服务当前可用；【不可用的代理会静默阻断所有同步请求】，且不报错、不提示。
方法二：临时禁用系统级代理
Windows：设置 → 网络和 Internet → 代理 → 关闭「自动检测设置」和「使用代理的服务器」；
macOS：系统设置 → 网络 → 当前连接 → 详细信息 → 代理 → 清空所有协议代理配置。
强制触发一次完整同步
第一步：关闭桌面端 TRAE Work 应用（不是最小化，是彻底退出）；
第二步：打开网页端，进入任意项目，做一次微小编辑（例如在标题末尾加一个空格）并保存；
第三步：重新启动桌面端，等待右下角托盘图标变为绿色同步状态；
第四步：在桌面端打开同一项目，观察是否自动拉取网页端刚做的修改。
若仍无反应，说明本地同步缓存已损坏，需执行下一步。
清除本地同步缓存
关闭桌面端 TRAE Work；
前往本地缓存目录：
Windows：C:\Users\{用户名}\AppData\Roaming\TraeWork\Cache；
macOS：~/Library/Application Support/TraeWork/Cache；
删除整个 Cache 文件夹；
重新启动桌面端，首次启动将重建同步索引，此时网页端与桌面端将重新对齐最新云端快照。
