框架约束与排错入口

WasiCore 游戏项目的命名、缩进、注释语言和代码组织由项目自行决定。本文只索引影响编译、运行和发布的框架约束。

按现象查找

现象或任务	阅读
类型找不到、客户端通过但服务端编译失败	项目结构与编译入口
初始化不执行、游戏模式判断无效、错过 UI 初始化	框架生命周期
Task.Run / Task.Delay 报错、异步等待卡住	WASM 异步与游戏时间
双端消息丢字段、玩家身份错误、控件销毁或碰撞回调异常	常见开发陷阱
GameData 公式在某一端编译失败	公式字段赋值位置
IGameLink 指向同一条目却比较不相等	IGameLink 比较
图片、Spine、音频、字体或普通文件找不到	项目资源路径
UI 字太小、设计尺寸与实际屏幕不一致	UI 字号与可读性
选择运行、联机和发布前的验证方式	游戏项目验证

日志入口

游戏诊断使用 Game.Logger，用参数记录玩家、对象或操作等上下文：

Game.Logger.LogInformation(
    "玩家 {PlayerId} 得分 {Score}", playerId, score);

通过编辑器启动项目后，运行时日志通常位于编辑器安装目录的 logs/client、logs/server；项目目录中的编译输出不能替代运行时日志。日志级别、异常记录和定位方法见日志系统。