加了UPROPERTY仍不显示在蓝图里，最常见原因是缺少“可见性+蓝图权限”双说明符：VisibleAnywhere/EditAnywhere控制编辑器可见性，BlueprintReadOnly/ReadWrite决定蓝图节点是否生成。
直接暴露变量给蓝图不是加个 UPROPERTY 就完事——它必须配合正确的说明符组合，否则蓝图里看不到、编辑器里不可调、运行时无法序列化，甚至热重载失败后变量凭空消失。
为什么加了 UPROPERTY 还是不显示在蓝图里？
最常见原因是漏掉「可见性 + 蓝图权限」双说明符。只写 UPROPERTY() 空括号，变量对反射系统注册了，但编辑器和蓝图默认都不展示它。
-
VisibleAnywhere或EditAnywhere决定是否出现在 Details 面板；没有它，连编辑器都看不见 -
BlueprintReadOnly或BlueprintReadWrite才让蓝图节点列表出现 Get/Set 节点；只加EditAnywhere不加 Blueprint 权限，蓝图里依然调不到 - 如果变量是组件指针（如
USceneComponent*），VisibleAnywhere是常规选择；普通数值变量则优先用EditAnywhere
EditAnywhere 和 EditDefaultsOnly 有什么实际区别？
区别直接影响策划能否在关卡中改单个 Actor 实例的值，也决定网络同步行为。
-
EditAnywhere：既能在蓝图编辑器修改默认值，也能在场景中选中具体 Actor 后，在 Details 面板实时编辑。适合调试期参数或实例特有配置（如每个敌人不同的巡逻半径） -
EditDefaultsOnly：只能在蓝图类的“Class Defaults”面板里改，关卡中所有该类实例共享这个值。发布前应把平衡性参数（如伤害倍率、冷却时间）全设为此项，避免策划误操作改坏运行时实例 - 注意：
EditDefaultsOnly的变量默认不参与网络复制；若需同步，得额外加Replicated说明符并实现GetLifetimeReplicatedProps
Category 和 meta(DisplayName) 怎么让蓝图面板更清晰？
Category 控制分组层级，meta=(DisplayName="...") 改的是蓝图里显示的名字，两者不互斥，但作用位置不同。
立即学习“C++免费学习笔记（深入）”；
-
Category="Gameplay|Health"会让变量出现在编辑器 Details 面板的 “Gameplay > Health” 折叠区域下；支持管道符嵌套，但别超过两层，否则折叠太深难找 -
meta=(DisplayName="最大生命值")只影响蓝图节点右键菜单和变量拖出时的文本，不影响编辑器面板显示名；中文命名建议全用，避免策划看不懂英文缩写 - 如果同时用了
Category和DisplayName，编辑器里显示的是原始变量名（如MaxHealth），但归入指定分组；蓝图里节点名才是DisplayName值
哪些类型变量不能直接用 BlueprintReadWrite？
不是所有 C++ 类型都能安全暴露给蓝图读写，引擎会在编译时静默过滤或运行时报错。
- 原生数组（
int32 MyArray[4]）不支持；必须用TArray<int32></int32>并加BlueprintReadWrite - 自定义结构体需先用
USTRUCT()标记，且所有成员也得是蓝图友好类型（如FVector、FString、UPROPERTY成员） - 指针类型（
AActor*）可以暴露，但仅限VisibleAnywhere或BlueprintReadOnly；BlueprintReadWrite对裸指针禁止，会编译失败 - STL 容器（
std::vector、std::map）完全不被反射系统识别，加UPROPERTY也没用
真正容易被忽略的是：UPROPERTY 不只是“让蓝图能看见”，它是告诉引擎“这个变量要进反射表、要参与序列化、可能被网络复制、会被 GC 追踪”。一旦说明符冲突（比如 EditAnywhere + Replicated 却没实现复制逻辑），或类型越界，问题往往延迟到打包后才爆发——而不是编译报错。
