游戏引擎 / 系统课时

用日志和调试工具定位异常

用日志和调试工具定位异常

“角色没动”可能来自入口没执行、引用没绑定或状态条件不满足。有效调试应先确认实际运行版本与调用路径,再停在关键分支检查变量。本节用启动探针把配置错误变成可定位的证据。

学习目标

  • 在日志中记录场景与对象身份
  • 用断点验证分支和调用顺序
  • 保留第一条错误并缩小复现步骤

先确认正在调试哪一个运行实例

记录当前场景、构建标识和目标节点 UUID,避免调试旧浏览器页签或过时构建。编辑器控制台与浏览器运行 Console 的来源可能不同;看到脚本文件保存成功,不代表预览已加载新代码。重启一次预览,确认新的启动标识真正出现。

日志优先放在状态迁移、加载完成和异常分支,别每帧打印整个场景树。大量日志会改变时序并淹没第一条错误。错误发生后先保留最早堆栈,后面的空引用往往只是连锁结果。

给空引用一个明确出口

保存 DebugBootProbe.ts,挂到激活节点,初次故意不绑定 target,验证错误信息;随后绑定 Player 再运行。该配置检查不会修改 Player 的运动状态。

ts
import { _decorator, Component, Node, director } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('DebugBootProbe')
export class DebugBootProbe extends Component {
    @property(Node) target: Node | null = null;
    start(): void {
        console.log('[boot]', { build: 'lesson-debug-01', scene: director.getScene()?.name, owner: this.node.uuid });
        if (!this.target) {
            console.error('[config] target is not assigned:', this.node.name);
            this.enabled = false; // 让问题停在配置边界
            return;
        }
        console.log('[target]', { id: this.target.uuid, active: this.target.activeInHierarchy });
    }
}

预期结果:未绑定时出现 [boot] 和 [config] target is not assigned:,没有 [target];绑定并重启后出现目标身份与激活状态。UUID 和场景名随项目变化,不要求复制某个固定值。

在最小分支上停住

打开浏览器开发者工具,在 target 检查行设断点,重新启动预览,观察 this、target 和调用栈。断点没有命中时先核对启动日志、脚本编译、源映射和运行页签,而不是立即怀疑调试器。需要只检查某个角色时使用条件断点,按节点身份或状态过滤。

异步错误要在发起请求和回调两端带上相同请求 ID,比较场景是否已退出、结果是否过时。碰撞重复扣血记录攻击身份、目标身份和前后生命;场景切换记录来源、目标和加载错误。上下文应服务于定位,避免无意义地输出大对象。

把复现缩成明确步骤与预期结果,例如“从 Menu 进入 Game,暂停后恢复,第一次拾取不计分”。修复后同时重跑原路径和相邻边界,确认不是关闭整个功能才让错误消失。发布前移除临时断点和刷屏日志,保留必要错误诊断与版本标识。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用日志和调试工具定位异常

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通