Bevy 入门:从安装到首个窗口
从安装 Rust 与创建项目开始,了解 Bevy 的实体组件系统、插件、事件和资源,并通过窗口与简单动画掌握开发流程。
- 1
安装 Rust 工具链
打开 Rust 官网安装 rustup,使用默认配置完成安装;在终端执行 rustc --version 与 cargo --version,确认命令可用。
- 2
创建 Bevy 项目
执行 cargo new bevy_demo --bin,进入项目目录,再运行 cargo add bevy;首次编译依赖较多,需耐心等待。
- 3
运行默认示例
执行 cargo run,观察默认 Bevy 窗口;确认渲染正常后,按 Ctrl+C 结束程序,再编辑 src/main.rs。
- 4
建立实体组件系统
在 main.rs 中定义 Rotation 组件,并用 add_systems(Startup, setup) 添加实体;通过查询访问 Transform 并修改旋转。
- 5
添加逐帧动画
定义 rotate_system,使用 Query<&mut Transform> 查询实体;用 time.delta_secs() 更新旋转角度,避免依赖固定帧率。
- 6
验证并优化开发体验
运行 cargo run,确认方块持续旋转;使用 cargo fmt 格式化代码,cargo check 快速检查错误,并尝试 cargo run 后自动重载资源。
💡 实用技巧
- 组件只存数据,系统负责处理逻辑
- 用 Query 批量读取或修改组件
- delta_secs 适配不同帧率
- 启用动态链接可缩短热重载等待
⚠️ 常见坑
- 修改代码后需重新编译并重启程序
- 系统参数缺少必要组件会触发编译错误
常见问题
Q:Windows 上安装 Rust 后终端找不到 cargo 怎么办?
重新打开终端,先执行 rustc --version 和 cargo --version 检查;若仍无法识别,请确认 rustup 安装完成,并将其默认工具链所在目录加入系统 PATH。
Q:执行 cargo add bevy 后一直编译怎么办?
首次编译需要下载并构建大量依赖,等待 cargo 完成即可。后续运行 cargo run 会复用已编译缓存;若需快速排查错误,可先执行 cargo check。
Q:代码改完为何窗口没有出现旋转方块?
确认 Rotation 组件已定义,setup 已通过 add_systems(Startup, setup) 注册,旋转系统也已加入调度;随后保存 src/main.rs,重新执行 cargo run,让修改后的代码重新编译并启动。