bevy-core-concepts

Bevy 0.19 — 核心概念（App、Plugin、Schedule、World）

何时使用此技能

• 设置新的 Bevy 应用或库插件。
• 决定系统应属于哪个 Schedule（Startup、Update、FixedUpdate、PostUpdate 等）。
• 编写需要 &mut World 的独占系统。
• 遇到 Schedule 循环、歧义诊断级别升高或延迟命令顺序错误。
• 想知道“X 应该在哪里运行？”

规范模式

use bevy::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugins(GamePlugin)
        .run();
}

pub struct GamePlugin;

impl Plugin for GamePlugin {
    fn build(&self, app: &mut App) {
        app.insert_resource(Score(0))
            .add_systems(Startup, spawn_world)
            .add_systems(Update, (read_input, apply_gravity).chain())
            .add_systems(FixedUpdate, simulate_physics)
            .add_systems(PostUpdate, sync_transforms);
    }
}

#[derive(Resource)]
struct Score(u32);

fn spawn_world(mut commands: Commands) {
    commands.spawn((Camera3d::default(), Transform::from_xyz(0.0, 4.0, 8.0)));
}

fn read_input(_keys: Res<ButtonInput<KeyCode>>) {}
fn apply_gravity(_t: Res<Time>) {}
fn simulate_physics(_t: Res<Time<Fixed>>) {}
fn sync_transforms(_q: Query<&mut Transform>) {}

// Exclusive system — full mutable World access, runs alone.
fn rebuild_index(world: &mut World) {
    let count = world.entities().len();
    world.insert_resource(EntityCount(count));
}

#[derive(Resource)]
struct EntityCount(u32);

Schedule 速查表

Schedule	用途
Startup	一次性设置。在 Update 之前运行一次。
PreUpdate	读取输入、网络数据接入、帧开始时的记账工作。
Update	每帧游戏逻辑。按渲染帧率运行。游戏系统的默认选择。
PostUpdate	Update 之后的响应式记账工作（变换传播在此处进行）。
Last	必须在 PostUpdate 之后运行的内容（少见）。
FixedFirst / FixedPreUpdate / FixedUpdate / FixedPostUpdate / FixedLast	确定性、按 tick 频率执行的工作：物理、网络模拟、游戏状态。每个渲染帧可能运行零次或多次，以追上 Time<Fixed>。

**经验法则：**如果系统必须在相同输入下无论帧率如何都产生相同结果，就将其放入 FixedUpdate。否则放入 Update。

Bevy 0.19 注意事项

• **SimpleExecutor 已移除。**它过去会在每个系统之后应用延迟命令。剩余的执行器会根据依赖信息安排 ApplyDeferred；如果下游系统必须在同一个 Schedule 中看到命令，请添加 .before、.after 或 .chain()。共享的可变访问会被串行化，但这本身并不能决定哪个系统先运行。
• **ScheduleBuildError 变体已重命名。**如果你使用 match 匹配它们，请更新：HierarchyLoop → HierarchySort(DiGraphToposortError::Loop(...))，DependencyCycle → DependencySort(DiGraphToposortError::Cycle(...))。
• **0.19 中配置执行器时需要传入执行器值。**将 set_executor_kind(ExecutorKind::SingleThreaded) 替换为 set_executor(SingleThreadedExecutor::new())（或 MultiThreadedExecutor::new() / default_executor()）。
• **0.19 中 Resource 实现了 Component。**过去仅用 Resource 来排除组件的泛型约束不再有效；请检查范围较广的组件查询和泛型 API。
• State::set() 现在总会触发状态转换——即使请求的状态与当前状态相同也是如此。若要保留过去“相同时不执行任何操作”的行为，请使用 next_state.set_if_neq(...)。
• 不要在 Update 中执行渲染世界的处理流程。主世界组件可以在此处准备渲染数据，但 GPU 处理流程应放在渲染 Schedule 中。请参阅 bevy-rendering。
• 独占系统会阻塞其 Schedule 中的所有内容——只有在确实需要 &mut World 时才使用（场景加载、批量反射、架构迁移）。

另请参阅

• bevy-ecs-systems — 参数、集合、条件、排序和歧义诊断。
• bevy-ecs-components — 实体数据。
• bevy-rendering — 渲染 Schedule 和系统。
• bevy-physics — Rapier 的 Schedule 安排和 PhysicsSet 排序。
• bevy-input-actions — 将帧输入传递到固定 tick。
• bevy-testing — 受控的 App 步进和手动时间。
• bevy-migration-0-18-to-0-19 — 执行器实例和资源作为组件。