Godot全局访问器状态机调用move_and_slide报方法未声明问题排查

报错核心原因 #

• move_and_slide 是物理碰撞体节点的专属方法：Godot 4.x中该方法属于CharacterBody2D/CharacterBody3D类，Godot 3.x中属于KinematicBody2D/KinematicBody类，Node2D基类没有定义这个方法，你写的State类继承自Node2D，直接调用自然会触发方法不存在的报错。
• 架构逻辑错位：你把物理移动执行逻辑放在了纯逻辑的状态类里，状态类本身不应该持有物理节点的方法权限，移动逻辑的执行主体应该是玩家本身的物理碰撞节点。
• 额外语法隐患：你代码里写的Global.player_isIdle == State.state_machine == playerStates.IDLE属于连续相等判断，GDScript会从左到右运算，先得到前两个值对比的布尔结果，再和第三个值对比，完全不符合“同时满足两个条件”的判断逻辑，后续就算解决了方法不存在的问题也会出状态判断异常。

适配全局访问器状态机的修复方案 #

核心原则是职责拆分：状态类只负责状态流转、移动数值计算，实际的物理方法调用交还给玩家的CharacterBody2D节点执行。

• 调整节点与脚本继承关系：玩家根节点类型设置为CharacterBody2D（3.x版本用KinematicBody2D），挂载玩家主脚本，所有原生物理方法统一在这个脚本里调用。State类不需要继承Node2D，作为纯逻辑类或者轻量Node节点运行即可，初始化时传入玩家节点的引用。
• 修正状态类逻辑，移除直接调用move_and_slide的代码：状态类计算完移动速度后，把速度赋值给玩家节点的velocity属性，由玩家主脚本在_physics_process生命周期里统一调用move_and_slide。
• 修正错误的链式条件判断，把连续等号改为逻辑与连接的独立判断。

修正后代码示例 #

玩家主脚本（挂载到CharacterBody2D类型的玩家根节点）

extends CharacterBody2D

var state_machine # 绑定你的全局状态机实例
@export var base_speed: int = 200
@export var sprint_speed: int = 300

func _physics_process(_delta: float) -> void:
    # 物理生命周期统一执行移动，当前类自带move_and_slide方法
    state_machine.active_state.handle_input()
    move_and_slide()

修正后的State类代码

class_name State

var player_ref: CharacterBody2D # 初始化时传入玩家节点引用
var state_machine = null
var current_move_speed = 200

enum playerStates{IDLE, WALK, RUN, USE, SHOOT}
enum ItemStates{ITEM_ON_GROUND, IS_EQUIPED}

func _init(p_player: CharacterBody2D, p_state_machine) -> void:
    player_ref = p_player
    state_machine = p_state_machine

func handle_input(_event: InputEvent = null) -> void:
    var input_dir := Input.get_vector("move_left", "move_right", "move_up", "move_down")
    # 修正原错误的连续等号判断
    if input_dir != Vector2.ZERO:
        current_move_speed = player_ref.base_speed
        if state_machine.current_state == playerStates.RUN and Input.is_action_pressed("sprint"):
            current_move_speed = player_ref.sprint_speed
        player_ref.velocity = input_dir.normalized() * current_move_speed
    else:
        player_ref.velocity = Vector2.ZERO

版本适配提示：如果使用Godot 3.x，将类继承改为KinematicBody2D，调用move_and_slide时传入velocity参数即可，逻辑拆分规则完全一致。

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