Godot Engine报错：对空实例设置'text'索引（值类型为String）

我在制作游戏过场动画时，复用了之前可用的文本框场景实例，但相同代码在第42行（label.text = ""）触发了Null Instance错误，即使注释掉该行代码也无法解决问题。代码如下：

extends Control


const CHAR_READ_RATE = 0.05

onready var textbox_container = $TextboxContainer
onready var label = $TextboxContainer/MarginContainer/HBoxContainer/Label

enum State {
    READY,
    READING,
    FINISHED
}

var current_state = State.READY
var text_queue = []

func _ready():
    print("Starting state: State.READY")
    hide_textbox()
    queue_text("placeholder text")

func _process(delta):
    match current_state:
        State.READY:
            if !text_queue.empty():
                display_text()
        State.READING:
            if Input.is_action_just_pressed("ui_accept"):
                label.percent_visible = 1.0
                $Tween.remove_all()
                change_state(State.FINISHED)
        State.FINISHED:
            if Input.is_action_just_pressed("ui_accept"):
                change_state(State.READY)
                hide_textbox()

func queue_text(next_text):
    text_queue.push_back(next_text)

func hide_textbox():
    label.text = ""
    textbox_container.hide()

func show_textbox():
    textbox_container.show()

func display_text():
    var next_text = text_queue.pop_front()
    label.text = next_text
    label.percent_visible = 0.0
    change_state(State.READING)
    show_textbox()
    $Tween.interpolate_property(label, "percent_visible", 0.0, 1.0, len(next_text) * CHAR_READ_RATE, Tween.TRANS_LINEAR, Tween.EASE_IN_OUT)
    $Tween.start()

func change_state(next_state):
    current_state = next_state
    match current_state:
        State.READY:
            print("Changing state to: State.READY")
        State.READING:
            print("Changing state to: State.READING")
        State.FINISHED:
            print("Changing state to: State.FINISHED")

func _on_Tween_tween_completed(object, key):
    change_state(State.FINISHED)
    get_tree().change_scene("res://scenes/room1.tscn")

问题核心原因 #

错误本质是label变量未成功获取到对应节点的引用，常见触发场景：

1. 节点路径错误：$TextboxContainer/MarginContainer/HBoxContainer/Label与实际场景的节点层级、名称不匹配（比如复用场景时节点结构被修改）
2. 实例化时机问题：如果场景是动态实例化的，onready变量可能在节点未完全加载时就尝试获取引用
3. 目标节点异常：Label节点被删除、或未正确添加到场景树中

解决方案 #

1. 校验节点路径正确性

• 在编辑器中选中脚本所在的Control节点，右键点击目标Label节点，选择「复制节点路径」，替换代码中onready var label = ...的路径
• 在_ready()中添加调试代码：print(label)，如果输出null，直接确认路径错误

2. 适配动态实例化场景

如果场景是通过代码动态创建的（比如instance()），将onready变量改为在_ready()中手动初始化：

var label = null

func _ready():
    label = $TextboxContainer/MarginContainer/HBoxContainer/Label
    if not label:
        print("Label节点未找到！")
    # 其他初始化逻辑

3. 排查节点状态

打开复用的文本框场景，确认：

• Label节点存在且未被删除
• 节点未被设置为「从场景树移除」状态
• 节点的owner属性正确关联到场景根节点

4. 解决注释代码仍报错的问题

即使注释第42行，display_text()、_process()中仍有多处访问label的代码，只要label为null就会触发错误。必须先解决label引用为空的问题，而非仅注释单一行代码。

快速调试技巧 #

在_ready()中添加以下代码定位问题：

func _ready():
    print("Starting state: State.READY")
    print("textbox_container:", textbox_container)
    print("label:", label)
    hide_textbox()
    queue_text("placeholder text")

如果textbox_container也输出null，说明上层容器节点的路径也存在错误，需优先修正。

内容的提问来源于stack exchange，提问作者c0ff334dd1ct