【 Godot 4 学习笔记】GDScript 注解实战手册

📘 Godot 4.x GDScript 注解实战手册

0. 前言：什么是注解？

在 Godot 4.x 中，注解（Annotations）是以 @ 开头的编译期指令。它们不是运行时的装饰器，而是直接告诉引擎：“如何处理这行代码”。

• 核心作用：连接代码与编辑器、控制静态分析、定义类结构。
• 黄金法则：注解只对其正下方紧邻的一行代码生效（区域控制注解除外）。

1. 编辑器集成篇：让策划爱上你的 Inspector

💡 批注：独立游戏中，良好的 Inspector 体验能减少 50% 的沟通成本。不要把所有变量裸露在外面，善用分组！

1.1 基础导出