Godot4中预加载场景实例在_ready()设置global_position报错求助

报错原因分析 #

1. 无效索引访问导致返回nil：循环中第一个元素（蛇头，x=0）调用get_segment_position时，函数内尝试访问snake_segments[x-1]即snake_segments[-1]，这会返回nil，最终函数无有效返回值（默认返回nil），给global_position赋值nil触发错误。
2. 节点未加入场景树导致变换未初始化：使用call_deferred添加子节点时，节点还未进入场景树，此时直接访问global_position可能因依赖父节点变换未初始化而出现异常。

修复方案 #

方案1：重构初始化逻辑，单独处理蛇头 #

extends Node

var snake_body_segment: PackedScene = preload("res://scenes/gameobjects/snake_segment/snake_segment.tscn")
var snake_head_segment: PackedScene = preload("res://scenes/gameobjects/snake_head/snake_head.tscn")
var snake_segments_list: Array[CharacterBody2D] = []


func _ready():
    # 初始化蛇头，设置明确的初始位置和速度
    var head = snake_head_segment.instantiate()
    snake_segments_list.append(head)
    get_parent().add_child(head)
    # 可根据你的游戏区域调整初始位置
    head.global_position = Vector2(400, 300)
    # 设置初始移动方向，避免速度为0时get_segment_position无返回值
    head.velocity = Vector2.RIGHT * 40

    # 初始化身体段
    for _ in range(2):
        var body_part = snake_body_segment.instantiate()
        snake_segments_list.append(body_part)
        get_parent().add_child(body_part)
        # 根据前一段位置计算当前段位置
        body_part.global_position = get_segment_position(snake_segments_list, snake_segments_list.size() - 1)


func _process(_delta):
    for x in range(1, snake_segments_list.size()):
        var tween = get_tree().create_tween()
        tween.tween_property(snake_segments_list[x], "position", get_segment_position(snake_segments_list, x), .5)


func get_segment_position(snake_segments: Array[CharacterBody2D], x: int) -> Vector2:
    # 蛇头直接返回自身位置
    if x == 0:
        return snake_segments[0].global_position
    
    var prev_segment = snake_segments[x-1]
    var direction = snake_segments[0].velocity.normalized()
    
    # 用match简化方向判断，同时处理速度为0的默认情况
    match direction:
        Vector2.RIGHT:
            return prev_segment.global_position + Vector2(-40, 0)
        Vector2.LEFT:
            return prev_segment.global_position + Vector2(40, 0)
        Vector2.DOWN:
            return prev_segment.global_position + Vector2(0, -40)
        Vector2.UP:
            return prev_segment.global_position + Vector2(0, 40)
        _:
            return prev_segment.global_position

方案2：保留call_deferred的情况下延迟设置位置 #

如果必须使用call_deferred添加节点，需要把设置global_position的操作也延迟执行，确保节点已加入场景树：

func _ready():
    var body_part
    # 先初始化蛇头
    body_part = snake_head_segment.instantiate()
    snake_segments_list.append(body_part)
    get_parent().add_child.call_deferred(body_part)
    # 延迟设置蛇头位置
    body_part.call_deferred("set_global_position", Vector2(400, 300))
    body_part.call_deferred("set_velocity", Vector2.RIGHT * 40)

    # 初始化身体段
    for _ in range(2):
        body_part = snake_body_segment.instantiate()
        snake_segments_list.append(body_part)
        get_parent().add_child.call_deferred(body_part)
        # 延迟设置身体段位置，需确保前一段已完成初始化
        var idx = snake_segments_list.size() - 1
        body_part.call_deferred("set_global_position", get_segment_position(snake_segments_list, idx))

关键优化点 #

• 给蛇头设置明确的初始位置和速度，避免get_segment_position因速度为0或无效索引返回nil。
• 给get_segment_position添加边界判断和默认返回值，确保函数始终返回有效的Vector2。
• 确保节点加入场景树后再操作global_position，避免变换未初始化的问题。

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