游戏 AI / 系统课时
自定义节点如何保持单一职责
自定义节点如何保持单一职责
自定义节点最容易从“小功能”长成难测试的万能类:它既查目标,又改黑板,还播放动画、扣血和发事件。本节用条件、查询、动作与副作用四类职责重新切边界,让节点更容易单测、复用,也更容易替换底层引擎实现。
学习目标
- 区分条件、查询、动作和副作用节点各自应该负责什么。
- 用小接口隔离感知、战斗等外部系统,避免节点直接依赖全局对象。
- 用可测试性判断一个节点是否承担了过多职责。
先让每类节点只回答一个问题
单一职责不是要求“一个节点只能写一行代码”,而是要求它只有一个清晰的变化原因。条件节点回答“现在是否允许继续”;查询节点回答“外部世界当前是什么”;动作节点回答“这个行为执行到什么状态”;副作用则负责“把结果写到哪里或通知谁”。

这种划分会让问题定位更直接。攻击失败时,你可以先判断是条件拒绝、查询没有目标、动作执行失败,还是结果没有正确写回,而不是进入一个数百行节点逐段猜测。
用小接口隔开外部系统
下面的 JavaScript 示例把四类职责拆成独立对象,并通过构造参数注入感知与战斗能力。示例不依赖游戏引擎,可以直接用 Node.js 运行。
const Status = Object.freeze({
SUCCESS: 'SUCCESS',
FAILURE: 'FAILURE',
RUNNING: 'RUNNING'
});
class NearestTargetQuery {
constructor(perception) {
this.perception = perception;
}
query() {
return this.perception.findNearestEnemy();
}
}
class WriteTargetEffect {
apply(context, target) {
context.blackboard.target = target;
}
}
class HasTargetCondition {
test(context) {
return context.blackboard.target != null;
}
}
class AttackAction {
constructor(combat) {
this.combat = combat;
}
tick(context) {
const target = context.blackboard.target;
return this.combat.attack(target) ? Status.SUCCESS : Status.FAILURE;
}
}
const perception = {
findNearestEnemy() {
return { id: 'enemy-17' };
}
};
const events = [];
const combat = {
attack(target) {
events.push(`attack:${target.id}`);
return true;
}
};
const context = { blackboard: { target: null } };
const query = new NearestTargetQuery(perception);
const writeTarget = new WriteTargetEffect();
const hasTarget = new HasTargetCondition();
const attack = new AttackAction(combat);
const target = query.query();
writeTarget.apply(context, target);
console.log(`Target acquired: ${context.blackboard.target.id}`);
console.log(`Has target: ${hasTarget.test(context)}`);
console.log(`Attack status: ${attack.tick(context)}`);
console.log(`Events: ${events.join(',')}`);预期输出:
Target acquired: enemy-17
Has target: true
Attack status: SUCCESS
Events: attack:enemy-17这个结构里,HasTargetCondition 不知道目标怎么被发现,NearestTargetQuery 不负责写黑板,AttackAction 也不负责重新选目标。任何一块都可以单独替换成测试桩,而不需要初始化整套游戏世界。
节点不该偷偷承担别人的工作
最常见的问题是条件节点出现副作用。例如 CanAttack 在检查距离时顺便启动寻路,或者 HasAmmo 在发现弹药不足时顺便触发换弹。这会让一次“只读判断”改变世界状态,父节点重复 Tick 时还可能把动作启动多次。
动作节点也容易越界。AttackAction 可以负责一次攻击的开始、持续轮询和取消,因为这些都属于同一个动作生命周期;但它不应该同时搜索最近敌人、选择武器、修改仇恨列表和统计战斗数据。
用可测试性验收接口设计
好的自定义节点应该可以在没有完整场景、动画系统和真实导航网格时验证。条件节点给一个黑板即可测试;查询节点注入假的感知接口即可测试;动作节点则注入假的战斗或导航接口,检查它如何映射底层结果到节点状态。
测试困难往往不是“测试框架不够强”,而是依赖边界不清。若一个节点必须先创建角色、加载动画、注册事件总线、初始化导航和生成敌人才能验证一个布尔条件,节点本身通常就太重了。
因此接口也应尽量传入它真正需要的能力,而不是一个可以访问全部系统的全局 GameManager。依赖越窄,替换成本越低,测试覆盖也越容易建立。
单一职责不等于机械拆碎
不要把每一次赋值都拆成独立节点。像 MoveTo 的“发起导航请求、后续 Tick 查询状态、收到打断时取消请求”虽然包含多个步骤,但它们共同维护一个移动动作的生命周期,放在同一个动作节点里更合理。
真正需要拆的是变化原因不同的逻辑:条件规则、世界查询、动作执行和外部副作用。节点边界稳定后,行为树本身会更像一张清晰的决策图,而不是把业务代码换一种方式塞进树节点。