godot-rust
Godot-Rust (gdext 0.5.x) API 使用指南、常见陷阱与最佳实践。在编写 Rust GDExtension 代码、使用 gdext 绑定、或遇到 gdext 编译/运行时问题时调用。
SKILL.md.trae/skills/godot-rust/SKILL.md
GitHubGodot-Rust (gdext 0.5.x) 开发指南
基于 gdext 0.5.3 的实战经验整理,涵盖 API 用法、易错点和最佳实践。
文档索引
| 文件 | 主题 | 关键内容 |
|---|---|---|
| 01-class-definition.md | 类定义与注册 | #[derive(GodotClass)]、#[var]/#[var(pub)]、#[func]、虚方法重写、信号定义 |
| 02-objects-and-types.md | 对象创建与类型转换 | new_gd()、from_init_fn()、upcast/downcast、call()/call_deferred()、ByValue/ByOption 类型不匹配 |
| 03-borrow-checker.md | 借用检查器 | bind()/bind_mut() 冲突、克隆避免借用冲突、let-else 模式 |
| 04-collections.md | 集合类型 | VarDictionary、Array、Variant 类型转换 |
| 05-signals.md | 信号连接 | connect_flags()、emit_signal()、ConnectFlags |
| 06-resources.md | 资源创建 | 内联 ShaderMaterial、from_init_fn() 创建对象 |
| 07-engine-api.md | 引擎 API | 版本检测、编辑器检测、输入处理 |
| 08-tilemap-layer.md | TileMapLayer API | set_cell_ex 构建器、虚方法列表、属性复制、API 名称差异 |
| 09-architecture.md | 架构模式 | 循环依赖处理(基类类型 + call()) |
| 10-imports-and-best-practices.md | 导入与最佳实践 | 常用导入清单、8 条最佳实践 |
快速查找
- 如何定义类? → 01-class-definition.md
#[var]vs#[var(pub)]? → 01-class-definition.md#[var(get, set)]自定义 getter/setter(Option<Gd<T>>)? → 01-class-definition.md#[func]方法跨模块调用报错? → 01-class-definition.md- 虚方法
_update_cells不被调用? → 08-tilemap-layer.md set_tile_set类型不匹配? → 02-objects-and-types.mdcall_deferred参数类型错误? → 02-objects-and-types.md- 如何扫描子节点并按名称分类? → 02-objects-and-types.md
- 如何动态创建子节点并添加到场景树? → 02-objects-and-types.md
- 批量同步属性到子节点(Variant clone)? → 02-objects-and-types.md
self.base_mut()借用冲突? → 03-borrow-checker.md- 循环中遍历 Vec<Gd<T>> 同时访问 self 其他字段? → 03-borrow-checker.md
- VarDictionary::get() 返回类型? → 04-collections.md
- 循环依赖怎么处理? → 09-architecture.md