如何为精灵实现自定义Z排序？基于3D物体global_position.z自动排序

问题背景 #

我需要将单个3D网格捕获为独立的2D精灵（注意：不是捕获整个视口，只针对单个网格），但目前生成的2D精灵绘制顺序不对——比如球体被画在立方体前面，不符合3D空间的实际深度关系。想要做一个类似CanvasItem的y_sort enabled的自定义深度排序功能，只要把排序依据设为对应3D物体的global_position.z，就能让2D精灵自动按3D深度排序。

为什么不用这些方案？ #

• 单独设置Z索引：如果带了子对象的两个物体重叠，会出现交错显示的问题，而且手动给每个物体设Z索引工作量太大，根本不适合批量场景。
• 重排场景树：3D物体是会移动的，这就需要不断调整2D场景树的顺序，当3D物体（包括子对象）数量多的时候完全不可行，还会破坏动画效果。

实现方案 #

核心思路是重写CanvasItem的绘制顺序逻辑，让2D精灵的绘制顺序直接绑定对应3D物体的Z轴位置：

1. 自定义2D节点类
   继承你用来显示捕获的3D网格的2D节点（比如Sprite2D），添加一个属性绑定对应的3D物体节点：

extends Sprite2D

@export var linked_3d_obj: Node3D # 绑定对应的3D物体

2. 重写绘制顺序方法
   利用CanvasItem的_get_draw_order方法，返回基于3D物体global_position.z的排序值。注意：Godot里绘制顺序数值越小，节点越先被绘制（也就是显示在下层），所以取-global_z，这样Z值越大的3D物体（离相机越近），对应的2D精灵会越晚绘制（显示在前面）：

func _get_draw_order() -> int:
    return -linked_3d_obj.global_position.z

3. 批量处理与子对象兼容
   对于带了子对象的3D物体，只需要把父3D物体的global_position.z传递给对应的2D父精灵，子精灵可以继承这个排序逻辑，避免子对象交错显示的问题。

4. 动态更新
   当3D物体移动时，global_position.z会自动变化，_get_draw_order会在每次绘制时读取最新值，不需要手动调整场景树或Z索引，完全自动适配动态场景。

补充说明 #

这个方案是基于自定义CanvasItem绘制顺序的延伸，完美解决了批量物体、带子对象、动态移动场景下的2D精灵深度排序问题，不需要额外的性能开销，也能兼容动画需求。

内容的提问来源于stack exchange，提问作者Manas R. Makde