【 Godot 4 学习笔记】@export

@export 是 Godot 引擎（特别是 GDScript）中最核心、最常用的注解之一。它的主要作用是将你脚本中的变量“暴露”到 Godot 编辑器的检查器（Inspector）面板中。

简单来说，它让你无需修改代码，就能在编辑器里直观地调整数值、拖拽节点或分配资源。

以下是 @export 的全方位教程，涵盖基础用法、高级技巧以及常见误区。

1. 基础用法：让变量可见可编辑

在 Godot 4.x 中，只需在变量声明前加上 @export。

extends Node2D

# 基础数据类型
@export var speed: float = 100.0
@export var health: int = 100
@export var player_name: String = "Hero"
@export var is_alive: bool = true

效果：当你选中挂载了该脚本的节点时，右上角的检查器面板会出现这些变量，你可以直接修改它们的值。

2. 节点与资源引用（拖拽赋值）

这是 @export 最强大的功能之一，它允许你通过拖拽的方式在编辑器里绑定节点或资源，替代了繁琐的 get_node() 或 load()。

绑定节点

@export var sprite: Sprite2D
@export var audio_player: AudioStreamPlayer
<