外观
日志系统
每个插件实例自带一个 Logger 属性,输出会自动打上插件名称前缀,并同时送往三个地方:
- Studio 控制台与 Unity
Debug.Log - 运行时内存循环历史缓冲区(可在 F10 面板的「运行日志」标签页查看)
- 本地磁盘日志文件:
%LOCALAPPDATA%\Studio 2.0\Logs\modloader.log
使用
csharp
Logger.Info("一般信息提示");
Logger.Warning("警告:某资源未能正常加载");
Logger.Error("操作失败", exceptionObj);
Logger.DebugLog("调试细节日志");约定
| 级别 | 用途 |
|---|---|
Info | 正常流程节点,用户可见的关键动作 |
Warning | 可恢复的异常、降级行为 |
Error | 操作失败,建议同时传入 Exception 对象以便打印堆栈 |
DebugLog | 排查期细节,正式发布前尽量收敛 |
排查加载失败
插件在加载阶段抛出的异常会被 Loader 捕获,连同完整堆栈一起显示在 F10 控制台的「已加载插件」页,并写入 modloader.log。用户报障时让对方提供这个日志文件即可。