1. trae 自动更新卡住时先搞清楚它到底在干什么trae 自动更新这件事表面上看就是「打开编辑器它自己下载、自己重启、自己升级」但真出问题的时候你会发现它既不报错也不升级就卡在那里。我遇到过好几次状态栏提示「正在下载更新」进度条走到 80% 不动了还有一次是重启之后版本号没变等于白更新了一遍。trae 的自动更新链路其实分四层版本检测、增量下载、静默安装、回滚兜底。这四层里任何一层出问题表现都是「更新失败」或者「更新后版本没变」但排查方向完全不同。如果你只是反复点「检查更新」基本没用因为问题可能根本不在检测环节。这篇文章面向两类人一类是更新失败想定位卡点的开发者另一类是希望自定义更新行为比如内网环境、想控制升级时机的人。我会从安装目录里的实际文件出发把 trae 自动更新的完整链路拆开给出可复制的配置片段和手动触发验证步骤。你跟着操作能确认自己的 trae 到底卡在哪一步。先明确一个前提trae 的更新执行器不是 Electron 自带的 autoUpdater 直接干活而是走了一套自定义逻辑。在 Windows 上真正替换文件的是tools/inno_updater.exe配合innoplugin.dll这是基于 Inno Setup 的增量更新机制。主进程main.js只负责「检查、下载、标记 pendingUpdate、调用 quitAndInstall」重启后的文件替换是另一个进程完成的。理解这个分工后面排查才不会找错地方。2. TaoToken 前置为什么更新排查要用到它在拆更新链路之前先说清楚 TaoToken 在这里的角色。trae 的版本检测和更新包下载最终都要请求一个远端接口拿版本信息。默认情况下它走的是官方 CDN但在一些网络受限的环境里这个请求可能超时或者返回异常表现出来就是「检查更新一直转圈」。TaoToken 提供的是统一的模型与接口接入能力官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的价值在于当你需要验证「更新检测请求到底通不通」时可以用它提供的接口做一次对照请求确认是网络问题还是 trae 自身逻辑问题。具体来说trae 的更新检测本质是一次 HTTP 请求拼接的路径类似/latest_${process.arch}。你可以用 TaoToken 的 API Key 去请求模型对话接口验证当前网络环境下 HTTPS 出站是否正常。如果 TaoToken 的请求能通而 trae 的更新检测不通那问题就锁定在 trae 的 feedURL 配置或者 CDN 可达性上而不是你的网络整体有问题。获取 API Key 的入口在 https://taotoken.net/api-keys 控制台在 https://taotoken.net/console 。如果你只是想快速验证模型请求是否正常可以直接用模型对话页面 https://taotoken.net/chat 。对于长期做编码和 Agent 开发的场景Coding Plan 页面 https://taotoken.net/coding-plan 里有更完整的接入说明。这里要强调一点TaoToken 不是用来「替代」trae 更新源的它是排查工具。你用它确认网络链路然后回到 trae 的更新配置里去定位问题。两者配合才能把「更新卡住」这件事拆清楚。3. 可复制配置app-update.yml 与更新行为控制trae 的更新配置文件在安装目录下的resources/app-update.yml。这个文件决定了更新提供方是谁、从哪拿版本信息。默认内容大致是这样provider: custom url: updaterCacheDirName: trae-updaterprovider: custom表示更新逻辑由 trae 自己的主进程代码控制不走 Electron 标准的 generic 或 github provider。url为空说明实际的 feedURL 是在main.js里动态拼接的而不是从这个 yml 里读固定地址。如果你想禁止自动更新最直接的方式是把 provider 改成 noneprovider: none url: updaterCacheDirName: trae-updater改完之后主进程在初始化更新模块时会跳过检查逻辑。注意这个文件在安装目录里修改前先备份因为 trae 升级时可能会覆盖它。另一个控制点是用户设置里的update.mode。在 trae 的 settings.json 里可以这样写{ update.mode: manual, update.enableWindowsBackgroundUpdates: false }update.mode可选值一般是default、manual、none。设成manual后trae 不会自动下载只在你手动点「检查更新」时才走完整流程。update.enableWindowsBackgroundUpdates设为 false 可以关掉 Windows 上的后台静默更新。如果你在做内网部署想把更新源指向自己的镜像可以修改 feedURL 的拼接逻辑。但main.js是 minified 的直接改不现实。更稳妥的做法是在 hosts 层面把官方 CDN 域名指向内网镜像或者用反向代理拦截更新请求。这部分涉及具体网络配置这里不展开。更新包的缓存位置在用户数据目录由product.json里的dataFolderName决定。trae 默认是.trae-cn所以缓存在%APPDATA%\.trae-cn\下。你可以去这个目录看有没有下载了一半的更新包如果有删掉再重新触发更新往往能解决「卡在 80%」的问题。4. 验证请求与手动触发确认更新到底走没走通配置改完之后怎么确认更新链路是通的分三步。第一步确认版本检测请求能发出。打开 trae 的开发者工具Help 菜单里通常有 Toggle Developer Tools在 Network 面板里过滤latest然后点「检查更新」。你应该能看到一个请求发往类似https://api.trae.com.cn/latest_x64的地址。如果这个请求根本没出现说明检查逻辑没被触发可能是update.mode设成了 none或者 provider 配置有问题。第二步确认下载能完成。如果版本检测返回了新版本主进程会开始下载更新包到%APPDATA%\.trae-cn\下。你可以在文件管理器里盯着这个目录看有没有临时文件在增长。下载完成后主进程会标记pendingUpdate状态。这个状态在main.js里对应pendingUpdate相关的处理逻辑标记成功后trae 会提示你重启应用。第三步手动触发安装。如果你不想等它自动重启可以主动调用quitAndInstall。在开发者工具的 Console 里执行require(electron).remote.app.quitAndInstall()注意新版 Electron 里remote模块可能被禁用那就需要在主进程侧触发。更简单的办法是直接重启 trae重启时inno_updater.exe会被调用配合innoplugin.dll执行增量替换。重启后打开 trae看 Help - About 里的版本号有没有变。如果你想验证更新包本身是否完整可以去%APPDATA%\.trae-cn\下找下载好的包检查文件大小和哈希。不过 trae 没有公开更新包的校验值所以这一步只能确认文件不是 0 字节或者明显截断。一个实用的技巧在重启之前先把%APPDATA%\.trae-cn\下的更新缓存目录整个备份一份。如果更新失败导致 trae 起不来你可以把备份的旧版本文件恢复回去相当于手动回滚。这个操作比等官方回滚策略触发要快得多。5. 本篇常见错排查401、local proxy failed、reading choices更新排查里最常见的几个报错我逐个拆。401 Unauthorized这个通常出现在你用了自定义更新源但鉴权信息没配对。trae 默认的更新请求不带用户鉴权走的是公开 CDN。如果你把 feedURL 指向了需要鉴权的内网源就会返回 401。排查方法是看 Network 面板里请求的 Headers确认有没有带 Authorization。如果带了但值不对检查你的代理配置。local proxy failed这个报错说明 trae 尝试走本地代理去请求更新接口但代理没起来或者端口不对。trae 会读取系统代理设置如果你开了某个本地代理工具但没正常运行就会报这个。解决办法是在 trae 设置里关掉代理或者确认代理端口和系统设置一致。注意这里说的是本地代理配置问题不涉及任何网络访问方式的选择。reading choices 报错这个一般出现在更新检测返回的数据格式不对时。主进程期望拿到一个包含版本号、下载地址的 JSON但如果 CDN 返回了 HTML 错误页或者空响应解析时就会报reading choices之类的错。排查方法是看 Network 面板里那个latest_x64请求的 Response 内容如果是 HTML 或者空说明 CDN 侧有问题不是 trae 的锅。OAuth 相关报错如果你在 trae 里登录了账号更新检测可能会带上 token。token 过期时会报 OAuth 错误。解决办法是退出登录再重新登录刷新 token。这个和更新逻辑本身无关但会阻断更新流程。更新后版本号没变这是最迷惑的情况。更新包下载了、重启了但版本号还是旧的。原因通常是inno_updater.exe执行替换时失败了但主进程没捕获到错误。排查方法是看%APPDATA%\.trae-cn\下有没有更新日志或者用 Process Monitor 监控inno_updater.exe的文件操作。常见失败原因是安装目录权限不足或者有文件被占用比如 trae 没完全退出。如果你在用 CC Switch 或者 Cline MCP 这类工具配合 trae注意它们的配置文件里 Base URL、Key、Model ID 三件套要写全。更新 trae 本身不会影响这些配置但如果更新后 trae 的扩展宿主重启MCP 连接可能会断需要重新加载。6. 把更新链路用起来从排查到自定义拆完这四层链路你应该能定位大部分更新问题了。核心思路是先确认版本检测请求有没有发出再确认下载有没有完成然后确认重启后替换有没有执行最后看回滚有没有兜底。对于想自定义更新行为的场景最实用的两个手段是改app-update.yml的 provider 和改 settings.json 的update.mode。前者控制更新源后者控制更新时机。两者配合基本能满足内网部署和升级管控的需求。如果你需要验证网络链路是否正常可以用 TaoToken 的接口做对照测试。API Keys 在 https://taotoken.net/api-keys 接入文档在 https://taotoken.net/doc 模型对话验证在 https://taotoken.net/chat 。长期做编码和 Agent 开发的话Coding Plan 页面 https://taotoken.net/coding-plan 里有更完整的方案。最后留一个实操建议每次手动触发更新前先把%APPDATA%\.trae-cn\下的更新缓存备份一份。这样即使更新失败你也能快速恢复到可用状态不用重装整个编辑器。这个习惯帮我省过好几次重装的时间。