游戏引擎 / 系统课时
Resource 隔离多个实例的数据
Resource 隔离多个实例的数据
两个角色看似各自拥有资源字段,修改其中一个的血量却影响了另一个,根因往往是它们指向同一个 Resource。本节复现共享引用的问题,对比显式复制与场景局部资源,并验证嵌套资源是否真的随外层一起隔离。
学习目标
- 用引用身份与属性变化复现 Resource 被多个角色共同修改的问题。
- 区分浅复制、深复制与
Local To Scene的实际作用范围。 - 通过场景实例化和嵌套资源检查,选择可靠的数据隔离方式。
看清共享引用与独立实例
Godot 把 Resource 作为引用对象管理。同一个 .tres 路径反复加载通常返回缓存中的同一对象;而创建两个场景节点,也不会自动让它们引用的每一份资源都变成独立副本。因而问题不在角色节点数量,而在运行时被修改的是哪一份资源。

准备可复现的资源与角色
为保证示例可以直接运行,在一个空 Godot 4.6 项目的 res:// 根目录分别创建以下脚本。BonusData 模拟嵌套的加成数据,RoleData 模拟角色资源。它们都是顶层脚本资源类,便于检查器正确保存。
res://bonus_data.gd:
class_name BonusData
extends Resource
# 故意设为可修改字段,用于检查嵌套引用是否共享。
@export var value: int = 5res://role_data.gd:
class_name RoleData
extends Resource
@export var hp: int = 100
@export var bonus: BonusDatares://role_unit.gd:
class_name RoleUnit
extends Node
# 场景实例读取的资源由检查器显式装配。
@export var stats: RoleData建立 res://role_unit.tscn,根节点类型为 Node,附加 role_unit.gd。在检查器的 Stats 属性中新建 RoleData,使 Hp=100,并在其 Bonus 字段中新建 BonusData,保持 Value=5。展开外层 RoleData 的 Resource 属性,启用 Local To Scene,然后保存场景。
另建 res://main.tscn,根节点为 Node,附加下文的 res://main.gd 并将该场景设为主场景。注意,局部标志必须在实例化前设定。
一次运行检验引用与复制
下面的测试先让两个变量共享一个资源,再进行浅复制和深复制,最后实例化两次 role_unit.tscn。is_same() 检查的是对象身份,而不只是数字是否相等。
res://main.gd:
extends Node
const ROLE_SCENE: PackedScene = preload("res://role_unit.tscn")
func _ready() -> void:
var template := RoleData.new()
template.bonus = BonusData.new()
# 两个变量引用同一对象:修改 A,B 也会观察到变化。
var a := template
var b := template
a.hp = 70
print("shared hp: %d / %d" % [a.hp, b.hp])
var shallow := template.duplicate() as RoleData
shallow.hp = 40
print("copied hp: %d / %d" % [shallow.hp, template.hp])
print("shallow bonus shared: ", is_same(shallow.bonus, template.bonus))
# 深复制全部子资源,避免继续修改同一份加成数据。
var deep := template.duplicate_deep(Resource.DEEP_DUPLICATE_ALL) as RoleData
deep.bonus.value = 99
print("deep bonus: %d / %d" % [deep.bonus.value, template.bonus.value])
var first := ROLE_SCENE.instantiate() as RoleUnit
var second := ROLE_SCENE.instantiate() as RoleUnit
add_child(first)
add_child(second)
print("local stats shared: ", is_same(first.stats, second.stats))
first.stats.hp = 30
print("local hp: %d / %d" % [first.stats.hp, second.stats.hp])预期输出:
shared hp: 70 / 70
copied hp: 40 / 70
shallow bonus shared: true
deep bonus: 99 / 5
local stats shared: false
local hp: 30 / 100这说明 duplicate() 默认复制外层的已存储属性,但嵌套 BonusData 仍保持共享;duplicate_deep(Resource.DEEP_DUPLICATE_ALL) 则会复制更深层的资源。Local To Scene 让标记的 RoleData 在每次 PackedScene.instantiate() 时变成独立实例,避免场景之间改写外层数据。
检查嵌套资源和复制边界
外层资源不同,不等于内部所有对象都不同。 资源属性中可能嵌套另一个 .tres、数组或字典。需要修改哪一层,就用 is_same() 检查哪一层;例如对两个角色的 stats.bonus 检查身份,而不要只看 stats 是否不同。
Godot 4.6 中,duplicate(true) 会递归复制数组和字典,但嵌套 Resource 默认只深复制内嵌或场景局部资源;duplicate_deep(Resource.DEEP_DUPLICATE_ALL) 连外部子资源也会复制。复制行为还会受属性的 ALWAYS_DUPLICATE 与 NEVER_DUPLICATE 使用标志影响。若引用了体积很大的外部纹理或其他只读资产,无差别深复制不仅没有必要,也可能增加内存占用。详细边界可查阅 Godot 4.6 Resource API。
Local To Scene 不是在运行中随手勾选就能拆开已有实例的开关;它在场景实例化时生效。检查器中的 Make Unique 是一次性创建独立资源,与“每次实例化都自动隔离”不是同一规则。
怎样选择隔离策略
| 数据用途 | 建议 |
|---|---|
| 角色职业基础数值、共享只读配置 | 引用同一 .tres,运行中不写回 |
| 临时需要修改的资源副本 | 显式 duplicate(),并逐层检查共享子资源 |
| 场景实例需要独立可变资源 | 实例化前启用 Local To Scene,验证嵌套引用 |
| 必须隔离整个资源对象图 | 按需使用 duplicate_deep() 并评估成本 |
排查“改一个角色影响另一个”时,优先记录资源的引用身份、发生写入的位置和实例化时机,而不是新增角色子节点。若变化的只是当前血量等状态,最稳妥的办法通常仍是把它留在节点或独立运行状态里,让共享 Resource 只负责提供初始配置。