GDScript中如何检测自定义类实例类型？解决类型判断失效问题

核心原因 #

你的BaseItem脚本是附加在RigidBody2D节点上的，所以body.get_class()返回的是节点类型（RigidBody2D），而非脚本类名。GDScript中判断自定义脚本类不能直接用is加预加载的脚本常量，需要用脚本专属的判断方式。

规范解决方案 #

方法1：定义class_name（官方推荐） #

在base_item.gd开头添加class_name声明，让脚本类成为全局可识别的类型：

# base_item.gd
class_name BaseItem extends RigidBody2D

# 你的物品逻辑代码...

派生类（比如HealthPotion）同样添加class_name：

# health_potion.gd
class_name HealthPotion extends BaseItem

# 药水逻辑代码...

之后在检测脚本里直接用is关键字判断，无需预加载：

func _on_area_body_entered(body):
    if body is BaseItem:
        print("物品进入交互范围")
    elif body is HealthPotion:
        print("生命药水进入交互范围")
    else:
        print(body.get_class())

方法2：对比script属性（通用兼容） #

如果不想用全局类名，可直接对比节点附加的脚本对象：

const BaseItem = preload("res://base_item.gd")
const HealthPotion = preload("res://health_potion.gd")

func _on_area_body_entered(body):
    if body.script == BaseItem:
        print("基础物品进入范围")
    elif body.script == HealthPotion:
        print("生命药水进入范围")
    # 判断是否为BaseItem的派生类
    elif body.script extends BaseItem:
        print("派生物品进入范围")

方法3：使用is_class方法（Godot 4.x专属） #

Godot 4.x支持用字符串类名直接判断，前提是脚本已定义class_name：

func _on_area_body_entered(body):
    if body.is_class("BaseItem"):
        print("物品进入交互范围")
    elif body.is_class("HealthPotion"):
        print("生命药水进入交互范围")

原方法失效原因 #

你预加载的itemClass是脚本对象，但body本质是RigidBody2D节点实例，默认is判断只会对比节点的基类类型（如RigidBody2D），不会关联附加的脚本类。只有通过class_name声明或直接对比script属性，才能正确识别自定义脚本类型。

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