最后同步日期：2026-04-15 | Godot 官方原文 — GDScript exports

GDScript 装饰器

想象你在填写一份表格，有些字段需要特别标注。装饰器（也叫注解）就是给代码加的便利贴，告诉 Godot 引擎这个变量或函数有什么特殊行为。

核心概念

• @export：让变量出现在编辑器的检查器面板中。
• @onready：让变量在节点进入场景树后才赋值。
• @rpc：标记函数可以被远程调用。
• @tool：让脚本在编辑器中也能运行。

---

装饰器总览

装饰器名	描述	使用频率	详细文档
@export	将变量导出到检查器面板	★★★	查看
@export_color_no_alpha	导出不含透明通道的颜色	★	查看
@export_dir	导出目录路径	★	查看
@export_enum	导出枚举选择器	★★	查看
@export_exp_easing	导出缓动曲线	★	查看
@export_file	导出文件路径	★	查看
@export_flags	导出位标志（多选开关）	★	查看
@export_global_dir	导出全局目录路径	★	查看
@export_global_file	导出全局文件路径	★	查看
@export_group	在检查器中创建属性分组	★★	查看
@export_multiline	导出多行文本编辑器	★	查看
@export_node_path	导出 NodePath	★	查看
@export_placeholder	导出带占位符的字符串	★	查看
@export_range	导出带范围限制的数值	★★	查看
@export_storage	导出存储属性（不显示在检查器）	★	查看
@export_subgroup	在分组内创建子分组	★	查看
@global_class	将类注册为全局可引用类型	★★	查看
@icon	为脚本设置自定义图标	★	查看
@onready	延迟变量初始化到 _ready() 时	★★★	查看
@rpc	标记函数为远程过程调用	★★	查看
@static_unload	脚本卸载时清除静态变量	★	查看
@tool	使脚本在编辑器中运行	★★	查看