如何在GDExtension中正确配置TypedArray并向GDScript暴露

一、MAKE_TYPED_ARRAY宏与TypedArray注册相关问题 #

• MAKE_TYPED_ARRAY宏的必要性：这个宏是Godot内部用来生成特定类型TypedArray的模板实现，对自定义类型（比如继承Resource/RefCounted的MyClass）并非必须。只要你的自定义类已经通过ClassDB完成注册，TypedArray就能自动兼容Variant系统。只有当你需要为数组实现特殊的序列化、反序列化逻辑时，调用这个宏生成针对性实现才有意义，否则用默认模板即可。
• 是否需要注册TypedArray：不需要单独注册TypedArray。Godot的Variant系统会自动识别TypedArray的类型参数，只要MyClass本身完成类注册，GDScript就能自动对应Array[MyClass]与TypedArray，这也是你测试中两种方式效果一致的原因。
• 返回值强制转Variant的原因：GDExtension与GDScript/引擎内部的通信完全基于Variant。虽然TypedArray本身兼容Variant，但绑定系统要求显式转换，目的是避免模板类型与Variant隐式转换可能带来的类型安全问题，确保数据传递的可靠性。

二、编辑器中数组类型显示与直接创建实例的解决方法 #

你遇到的编辑器数组显示无类型、需手动选择类型的问题，核心是没有给TypedArray属性添加正确的类型提示，导致编辑器无法识别数组元素类型。解决步骤如下：

1. 绑定属性时显式指定数组元素类型：
   在用godot-cpp绑定TypedArray属性时，需要通过PropertyInfo的PROPERTY_HINT_ARRAY_TYPE提示指定元素类型。示例代码：

   // 绑定get/set方法
   ClassDB::bind_method(D_METHOD("get_test_objects"), &TypedArrayTest::get_test_objects);
   ClassDB::bind_method(D_METHOD("set_test_objects", "value"), &TypedArrayTest::set_test_objects);
   // 添加属性时指定数组元素类型为MyClass
   ADD_PROPERTY(PropertyInfo(Variant::ARRAY, "test_objects", PROPERTY_HINT_ARRAY_TYPE, "MyClass"), "set_test_objects", "get_test_objects");
   

   这里的关键是PROPERTY_HINT_ARRAY_TYPE的第三个参数要填你的自定义类名称（比如"MyClass"），编辑器会根据这个提示识别数组元素类型，从而提供直接创建MyClass实例的选项。

2. 确保自定义类的注册信息正确：
   如果MyClass继承自Resource，除了基础的类注册，还可以添加资源类标识，帮助编辑器更好识别：

   ClassDB::register_class<MyClass>();
   ClassDB::add_resource_class<MyClass>(); // 标记为可创建的资源类型
   

   这样编辑器就能明确MyClass是可直接创建的类型，而非泛型Object。

3. 验证效果：
   完成上述设置后，在GDScript中@export该类实例时，属性编辑器里的数组会显示为Array[MyClass]，添加元素时会直接出现创建MyClass的选项，和纯GDScript实现的体验完全一致。

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