GFramework/GFramework.Godot.SourceGenerators
GeWuYou b95c65a30e refactor(generator): 优化GetNodeGenerator代码结构
- 使用语法树遍历替代字符串匹配来检测注入方法调用
- 添加IsGeneratedInjectionInvocation辅助方法提高代码可读性
- 将字段分组逻辑从列表查找改为字典映射提升性能
- 优化GroupByContainingType方法的时间复杂度
2026-03-22 15:23:51 +08:00
..

GFramework.Godot.SourceGenerators

面向 Godot 场景的源码生成扩展模块,减少模板代码。

主要功能

  • 与 Godot 场景相关的编译期生成能力
  • 基于 Roslyn 的增量生成器实现
  • [GetNode] 字段注入,减少 _Ready() 里的 GetNode<T>() 样板代码

使用建议

  • 仅在 Godot + C# 项目中启用
  • 非 Godot 项目可只使用 GFramework.SourceGenerators

GetNode 用法

using GFramework.Godot.SourceGenerators.Abstractions;
using Godot;

public partial class TopBar : HBoxContainer
{
    [GetNode]
    private HBoxContainer _leftContainer = null!;

    [GetNode]
    private HBoxContainer _rightContainer = null!;

    public override void _Ready()
    {
        __InjectGetNodes_Generated();
        OnReadyAfterGetNode();
    }

    private void OnReadyAfterGetNode()
    {
    }
}

当未显式填写路径时,生成器会默认将字段名推导为唯一名路径:

  • _leftContainer -> %LeftContainer
  • m_rightContainer -> %RightContainer