tmodloader 中文文档 下载 App

崩溃日志怎么看:从 client.log 找到最后一个报错

安全模式是救急,日志是破案。tModLoader 的每次崩溃都会留下记录,绝大多数「不知道哪个模组干的」问题,日志最后一屏就有答案。

日志在哪

tModLoader 的日志集中在一个专用目录:

平台路径
Windows文档\My Games\Terraria\tModLoader-Logs

(1.3 旧版是存档目录下 ModLoader\Logs 的 Logs.txt,老玩家注意路径已变。)里面你最常打交道的两个文件:

目录里还有个 Old 文件夹,存着历史运行日志——刚才那次崩溃的现场就在 Old 里最新的那份。

读法:从下往上

日志很长,但崩溃原因几乎总在最后一条异常附近。社区排障的标准读法:

  1. 打开 client.log,拉到最底部;
  2. 找最后一条 Exception(异常)——这就是压垮游戏的直接原因;
  3. 往上一两行,通常能看到模组名或抛出异常的代码位置;
  4. 把模组名记下来,去 管理模组 处理:更新、禁用或移除。

先打开一个开关

排查前确认游戏内 设置 → tModLoader 设置 → Always log exceptions(始终记录异常) 为开启。默认设置下部分异常不会被完整记录,关着它可能白看一遍日志。

对照排查流程

  1. 崩了 → 开安全模式确认是模组侧问题(见 安全模式);
  2. 开 Always log exceptions → 复现一次崩溃;
  3. 读 client.log 最后的 Exception,锁定模组名;
  4. 按名处理,或对照 报错速查 认错误类型;
  5. 崩溃模式是「每次启动必崩」的,配合 崩溃循环自救 改 enabled.json。

提交求助时带上日志

社区论坛和 Discord 求助的第一句话永远是「发日志」。把 client.log 整份附上(或 Old 里最新那份),比口头描述「玩着玩着就崩了」有效一百倍。日志里的版本号、模组清单、异常栈是别人能帮你的全部依据——这也是 社区资源 一页列的求助渠道的通用礼仪。