A380X 机载系统仿真架构深度解析:从构建流程到 Rust 洋葱式设计的完整指南

原创2026-10-12 16:22:561,330 阅读
文章标签:游戏开发

A380X 机载系统仿真架构深度解析:从构建流程到 Rust 洋葱式设计的完整指南

导读

本文以 A380X 项目(社区驱动的开源空客 A380 模拟项目)的机载系统仿真代码库为核心,系统讲解 fbw-a380x/src/wasm/systems/README.md 所定义的软件设计哲学与落地实现:如何在 Microsoft Flight Simulator 之外构建可独立测试的 Rust 系统仿真(WASM),如何通过洋葱式架构与 Visitor 模式将"飞机系统模型"与"模拟器交互"彻底解耦,以及如何保证状态一致性、多机型复用与强制单元测试。读完本文,你将掌握该仓库系统的构建命令、8 条设计需求与对应实现模式、SimulationElement 访问者模式的完整用法,以及 SimulationTestBed 驱动的测试写法,可直接用于 A320X/A380X 机模系统开发或同类飞行模拟仿真框架的设计参考。


一、概述:这个目录在仿真项目中扮演什么角色

fbw-a380x/src/wasm/systems/ 目录存放的是空客飞机机载系统(aircraft systems)的仿真代码——注意这里"系统"指的是飞机的电气、液压、引气、燃油等物理分系统,而非软件系统。它并不包含飞行物理(气动/发动机推力)本身,而是负责模拟"这些飞机部件在真实 A380 上是如何工作与相互耦合的"。

该目录由三个部分组成:

目录 / 文件 作用
a380_systems/ A380 机型专属系统模型,包含 A380 机型聚合体及电气、液压、燃油、空调、起落架等子系统(机型模型入口)
a380_systems_wasm/ MSFS WASM 仪表入口,负责把机型模型桥接到 Flight Simulator 的 SimConnect(WASM 入口)
guidelines.md 社区开发规范(基于 Pull Request 评审意见沉淀),与本 README 配套阅读(开发规范)

值得注意的是,a380_systems 通过 Cargo 依赖(见 a380_systems/Cargo.toml 中的 systems = { path = "../../../../../fbw-common/src/wasm/systems/systems" })共享了 fbw-common 下的通用 systems 库——所有机型共用的仿真基础设施(SimulationElement、Simulation、SimulationTestBed、单位系统等)都位于 fbw-common/src/wasm/systems/systems/src/simulation/mod.rs,这正是"多机型复用"需求的落地根基。


二、如何构建(How to build)

原文档给出的构建路径是"绕过仓库标准构建流程、单独构建本目录内容"的快捷方式,步骤如下:

  1. 安装 wasm32-wasi 编译目标,执行:
    rustup target add wasm32-wasi
    
  2. 安装 LLVM 12(MSFS 的 WASI 工具链依赖较旧版本的 LLVM),安装后确保其已加入系统 PATH。
  3. 在仓库顶层(a32nx 仓库的顶层目录)的控制台执行:
    cargo build --target wasm32-wasi
    
    此步骤要求你已安装 MSFS SDK,并且下载了 SDK 中独立于核心分发的 Samples 文件夹——这是编译 msfs-rs(MSFS Rust 绑定)所必需的前置条件。
  4. 构建产物为 target/wasm32-wasi/debug/a320.wasm(即 lib.rs 编译后的 WASM 文件)。

结合当前仓库结构可以看到,A380X 侧的对应产物由 a380_systems_wasm/src/lib.rs 中的 #[msfs::gauge(name=systems)] 入口编译而来。该入口还设置了一个全局 panic 钩子:当 WASM 实例因 panic 中止时,默认输出会丢失,因此代码在 trap 发生前把 panic 消息打印到 MSFS 控制台并上报诊断:

std::panic::set_hook(Box::new(|panic_info| {
    println!("A380X_SYSTEMS PANIC: {panic_info}");
    report_diagnostic(&format!("A380X_SYSTEMS PANIC: {panic_info}"));
}));

说明:上述命令以原文档为准。若在镜像仓库中直接复现,请以仓库实际的顶层目录与依赖路径为准,并确保 WASI 目标、LLVM 12 与 SDK Samples 均就绪。


三、软件设计:控制概念数量,用洋葱架构约束结构

原文档开篇点明了一条核心设计哲学:

良好的软件设计首先应聚焦于定义软件中存在的结构性概念,且概念的数量应当被限制,以免开发者不断陷入"为了实现 z,我该用概念 x 还是 y?"的纠结。

正是基于"限制概念数量"这一前提,系统的整体设计才得以确立。在进入需求清单之前,文档先给出了三组关键定义,避免歧义:

  • System(系统):不是指软件系统,而是指飞机的一部分,例如电气系统(electrical system)。
  • Model(模型):软件中与真实飞机部件对应的部分,例如 ElectricalSystem、Engine、EngineGenerator 等。
  • Software(软件):我们正在构建的东西本身。

8 条设计需求(Requirements)

  1. 可在模拟器之外运行(Runs outside the simulator):软件应当能够脱离模拟器,通过单元测试或控制台应用运行与测试。
  2. 模拟器交互位于模型之外(Simulator interactions outside the model):模拟器与模型之间的交互必须分离,使模型对模拟器的存在一无所知——这是达成需求 1 的手段。
  3. 保证状态一致(Guarantee consistent state):模型的每一次更新都必须使模型处于一致状态;不允许"需要多个 tick 才能收敛到正确状态",除非实在别无他法。编程模型应当让这一点易于保证。
  4. 状态可被观察(Observable state):部分系统需要在不通知模型本身的前提下观察模型某些部分的状态,例如:为电气系统中接触器开/关播放不同音效、在下 ECAM 上显示故障与操作建议。
  5. 可在多种空客机型间复用(Reuse in multiple Airbus aircraft types):模型的某些部分可跨机型复用。例如"电气系统包含汇流条、接触器、发电机"对所有飞机都成立,而"哪些接触器开、哪些关"则是机型专属决策。
  6. 支持不同飞行阶段的起始状态(Starting state for different phases of flight):模型应能轻松初始化为冷舱(cold and dark)、跑道上、飞行中等不同阶段。
  7. 单元测试是强制的(Unit tests are mandatory):自动测试是快速且相对无错开发的关键,单元测试与集成测试(不是与 MSFS 联调,而是组合模型各部件)必须被完整支持且强制要求。
  8. 单位不产生歧义(No confusion about units):模拟器暴露的数据单位繁杂(磅、千克、升、加仑、伏特、安培等),极易在开发中造成混淆,必须加以规避。

这 8 条需求是整份设计文档的骨架,接下来的实现章节逐条与之对应。


四、需求到实现的逐条落地

1. 可在模拟器外运行 → 洋葱式架构

为满足需求 1,所有与模拟器交互的代码都被放置在"建模飞机系统"的代码之外,形成洋葱式(onion-like)设计:核心是纯模型,外层才是模拟器桥接层。

原文档给出了 systems gauge 的入口示例。在核心模型中,A320 与 Simulation 两个类型完全不知道自己运行在模拟器里,因此它们以及它们引用的所有类型,都可以在不开模拟器的情况下独立运行:

#[msfs::gauge(name=systems)]
async fn systems(mut gauge: msfs::Gauge) -> Result<(), Box<dyn std::error::Error>> {
    let mut reader_writer = A320SimulatorReaderWriter::new()?;
    let mut a320 = A320::new();
    let mut simulation = Simulation::new(&mut a320, &mut reader_writer);

    while let Some(event) = gauge.next_event().await {
        if let MSFSEvent::PreDraw(d) = event {
            simulation.tick(d.delta_time());
        }
    }

    Ok(())
}

在 A380X 侧,同构的入口位于 a380_systems_wasm/src/lib.rs:它通过 MsfsSimulationBuilder 以 A380::new 构建机型模型,并在主循环中处理事件:

let (mut simulation, mut handler) = MsfsSimulationBuilder::new(
    key_prefix,
    Variable::named(&format!("{}START_STATE", key_prefix)),
    sim_connect.as_mut().get_mut(),
)
// ...配置电气汇流条、APU、防冰、燃油泵、故障表、飞行器变量、aspects...
.build(A380::new)?;

while let Some(event) = gauge.next_event().await {
    handler.handle(event, &mut simulation, sim_connect.as_mut().get_mut())?;
}

也就是说,进入模拟器的只有最外层桥接代码,A380 模型本身与模拟器零耦合。

2. 模拟器交互置于模型之外 → Visitor 模式 + 三个阶段

一个不与模拟器交互的仿真是没有意义的。为了既保持解耦又能交互,Simulation 类型按以下三个主要阶段运行:

  1. 读取:把模拟器数据读入仿真模型;
  2. 执行:运行仿真计算;
  3. 写入:把仿真模型的数据写回模拟器。

阶段 1 和 3 使用 Visitor(访问者)模式完成。选择访问者的原因是:模型之外的代码无需了解模型内部结构,因此随时间演进时改动更容易。

核心 trait:SimulationElement

SimulationElement trait 是让一个元素"可被访问"、从而可读写信息的主要手段。当你为一个类型实现 SimulationElement 时,默认行为是只访问该类型自身、不访问其他任何东西:

pub trait SimulationElement {
    fn accept<T: SimulationElementVisitor>(&mut self, visitor: &mut T)
    where
        Self: Sized,
    {
        visitor.visit(self);
    }
}

如果该类型由其他 SimulationElement 类型组合而成,则需要扩展 accept 函数,让访问者递归地访问所有子元素,并且不要忘记访问自己:

impl SimulationElement for A320 {
    fn accept<T: SimulationElementVisitor>(&mut self, visitor: &mut T) {
        // These types are all a SimulationElement as well.
        self.apu.accept(visitor);
        self.apu_fire_overhead.accept(visitor);
        self.apu_overhead.accept(visitor);

        // Don't forget to visit yourself
        visitor.visit(self);
    }
}

A380 的 SimulationElement 实现(见 a380_systems/src/lib.rs 第 360-404 行)正是这一模式的规模化范本:它把 ADCN、ADIRS、空调、APU、电气、燃油、四台 Trent 发动机、液压、起落架、气动、CDS、EGPWC、防冰、结构柔性、反推等全部子元素依次 accept,最后 visitor.visit(self)。

从模拟器读取信息:read

SimulationElement 内含 read 与 write 函数。read 用于从模拟器读取信息。原文档的 Engine 示例非常经典,值得完整保留:

pub struct Engine {
    corrected_n2_id: String,
    corrected_n2: Ratio,
}
impl Engine {
    pub fn new(number: usize) -> Engine {
        Engine {
            corrected_n2_id: format!("TURB ENG CORRECTED N2:{}", number),
            corrected_n2: Ratio::new::<percent>(0.),
        }
    }
}
impl SimulationElement for Engine {
    fn read(&mut self, reader: &mut SimulatorReader) {
        // As this function is invoked for every simulation tick
        // we try not to format the string here, but instead do it
        // once in the constructor function.
        self.corrected_n2 = Ratio::new::<percent>(reader.read_f64(&self.corrected_n2_id));
    }
}

其中有一个值得借鉴的性能细节:read 在每个仿真 tick 都会调用,所以不要在 read 里做字符串格式化,而是在构造函数里一次性拼好变量名(如 TURB ENG CORRECTED N2:1),read 时直接复用。

向模拟器写入信息:write

write 用于把仿真结果写回模拟器。原文档的 APU 示例展示了如何同时写出浮点与布尔量:

impl<T: ApuGenerator, U: ApuStartMotor> SimulationElement for AuxiliaryPowerUnit<T, U> {
    fn write(&self, writer: &mut SimulatorWriter) {
        writer.write_f64(
            "APU_FLAP_OPEN_PERCENTAGE",
            self.air_intake_flap.open_amount().get::<percent>(),
        );
        writer.write_bool("APU_BLEED_AIR_VALVE_OPEN", self.bleed_air_valve_is_open());
    }
}

目前读写仅原生支持 f64 类型;由于 bool 可用 f64 表示(1.0/0.0),因此也顺带支持了布尔。需要说明的是,在共享库 simulation/mod.rs 中,这套能力已经被泛化为 Read<T> / Write<T> trait,并通过宏为 Velocity、Length、Ratio、ElectricPotential、Pressure、Volume、Mass、Angle、Duration、bool、各类整数、MachNumber、StartState 乃至 ARINC 429/825 字等几十种类型批量实现了 f64 转换(见 read_write_uom!、read_write_as!、read_write_into! 宏)。

A32NX_ 前缀自动添加

开发者不需要手动给变量名加 A32NX_ 前缀——该前缀由 a320_systems_wasm 项目中的代码自动添加。在 A380X 侧同样如此,a380_systems_wasm/src/lib.rs 中显式声明了 let key_prefix = "A32NX_";,所有经 Variable::named 注册的变量都会自动带上此前缀。

读取飞行器变量(Aircraft Variables)

读取 MSFS 的飞行器变量需要额外工作:在 A320SimulatorReaderWriter 中定义 AircraftVariable,并在该类型的 read 函数中登记:

fn read(&mut self, name: &str) -> f64 {
    match name {
        "OVHD_ELEC_APU_GEN_PB_IS_ON" => self.apu_generator_pb_on.get(),
        // ...
    }
}

这里使用的字符串,就是模型内(对模拟器无感知的那部分代码)引用该变量时所用的名字。在 A380X 入口中,飞行器变量通过 provides_aircraft_variable(name, units, index) 批量注册,例如 AIRSPEED INDICATED(Knots)、AMBIENT PRESSURE(inHg)、TURB ENG CORRECTED N1(Percent,索引 1-4)、PAYLOAD STATION WEIGHT(Pounds,索引 1-18)等;另有一些面板开关则是通过 with_aspect 的 copy 把飞行器变量/命名变量"镜像"成模型变量,例如把 GENERAL ENG MASTER ALTERNATOR(Bool,i)复制为 OVHD_ELEC_ENG_GEN_{i}_PB_IS_ON。

3. 保证状态一致 → 显式依赖顺序 + 模块间弱耦合

要达成一致状态,计算之间的依赖关系必须清晰可见。原文档举了一个经典的循环依赖案例:判断"APU 起动马达是否通电"需要先知道电气系统状态,而电气系统状态又依赖 APU 状态。解决办法是把更新顺序显式化——先更新 APU 的"电气前置"逻辑,再更新电气系统,最后更新 APU 的"电气后置"逻辑:

impl Aircraft for A320 {
    fn update_before_power_distribution(&mut self, context: &UpdateContext) {
        self.apu.update_before_electrical(
            context,
            // ...
        );

        self.electrical.update(
            context,
            // ...
            &mut A320ElectricalUpdateArguments::new(
                // ...
                &mut self.apu,
                // ...
            ),
        );

        self.apu.update_after_electrical();
        self.electrical_overhead
            .update_after_electrical(&self.electrical);
        self.apu_overhead.update_after_apu(&self.apu);
    }
}

核心原则是:通过参数传递信息,而不是持有"全局"引用,由此保证一致状态。

A380 的 Aircraft 实现(a380_systems/src/lib.rs 第 176-359 行)把这一原则放大到了整机尺度:update_before_power_distribution 阶段先让 APU 准备电气输入,再更新电气系统(self.electrical.update(...),传入四台发动机、外部电源、LGCU、ADIRS 等),随后更新各顶板面板;update_after_power_distribution 阶段才依次更新 APU 后续逻辑、ADCN、防火、无线电高度表、液压、气动、空调、燃油、反推、结构柔性等——每类计算都发生在它的输入被保证就绪之后。

模块依赖:面向 trait 而非具体类型

APU 与电气系统定义在不同的模块中。为了保证易测试性,模块的依赖数量应尽量少。原文档特别指出:上面的例子里 APU 被传入 A320ElectricalUpdateArguments,但后者并不期待一个真实的 APU 实例,而是期待一个实现了 AuxiliaryPowerUnitElectrical trait 的实例——该 trait 定义在 systems/shared 中。于是 A320 电气系统可以在不引入完整 APU 实现的情况下单独测试。A380 的 apu: AuxiliaryPowerUnit<Pw980ApuGenerator, Pw980StartMotor, Pw980Constants, 2> 声明也印证了这一点:APU 通过泛型参数注入发电机、起动马达与常量,保持模型间弱耦合。

4. 状态可被观察 → 依然用 Visitor

作者最初考虑引入某种发布/订阅机制,把模型内部变化作为事件暴露给外部。但这样会引入又一个新概念,并增加模型自身的职责——这与"限制概念数量"的初衷相悖。因此,可观察状态同样复用 Visitor 模式。从实践结果看,"到目前为止效果很好"。

5. 多机型复用 → 组合 + 构造参数注入差异

只要坚持需求 1 与需求 2(模型与模拟器解耦、按机型组合类型),就可以通过"用不同方式组合为 A320 创建的类型"来实现 A380 的部分功能。机型间的细微差异(例如不同发动机型号下发动机发电机的冷却系数不同)可以通过在 new(构造函数)中作为输入参数传入来解决。共享 systems 库位于 fbw-common 正是这一复用策略的物理体现:A320X 与 A380X 共用同一套仿真基础设施与通用部件实现。

6. 不同飞行阶段的起始状态 → .flt 文件 + 起始状态访问者

目前,各种 .flt 文件被用于在正确的系统状态下起动。若这些还不够,则可用前文提到的 Visitor 模式为模型施加不同的起始状态:

fn main() {
    let mut airbus = A320::new();

    // Ignore boxing for the sake of example simplicity.
    let startingStateVisitor = match starting_state {
        StartingState::ColdAndDark => ColdAndDarkStartVisitor {},
        StartingState::InFlight => InFlightStartVisitor {},
        // etc.
    }

    airbus.accept(&startingStateVisitor);
}

在共享库中,StartState 枚举(simulation/mod.rs 第 65-108 行)提供了 8 档正式状态:Hangar、Apron、Taxi、Runway、Climb、Cruise、Approach、Final,与 f64 值 1-8 双向映射,并配套测试断言其转换与默认值(默认 Cruise)。A380X 入口通过 A32NX_START_STATE 变量读取起始状态,InitContext 则据此提供 is_in_flight()、is_on_ground()、has_engines_running()、start_gear_down() 等辅助判断(见 simulation/mod.rs 第 110-167 行),让各子系统在构造时就能依据飞行阶段设定正确初值。

7. 单元测试是强制的 → SimulationTestBed

原文档中的规则毫不含糊:

单元测试是强制性的。没有完整单元测试套件的贡献将不会被批准。

由于成功抽象掉了模拟器,单元测试的实现变得容易。项目提供了多种测试工具,其中 SimulationTestBed 类型可以对传入的 Aircraft 或 SimulationElement 执行一次完整的仿真 tick。其实现位于 fbw-common/src/wasm/systems/systems/src/simulation/test.rs:它内部组合了 TestReaderWriter、Simulation 与 TestVariableRegistry,new 时默认注入 250 节指示空速、5000 英尺气压高度、0°C、29.92 inHg 等标准环境,并支持 run()(1 秒 tick)、run_with_delta(delta)、run_multiple_frames(delta)(按 12-200ms 随机分帧模拟真实帧率)、fail/unfail(注入/解除故障)、command/query(操作/查询飞机状态)等全套能力。

由于待测场景数量庞大,文档强烈建议使用 builder 风格的测试类型来提高可读性,例如:

#[test]
fn contactor_opens_after_three_minutes_of_being_closed_for_apu_start_in_emergency_elec() {
    let test_bed = test_bed_with()
        .emergency_elec()
        .available_emergency_generator()
        .and()
        .apu_master_sw_pb_on()
        .run(Duration::from_secs(
            ClosedContactorObserver::EMER_ELEC_APU_MASTER_MAXIMUM_CLOSED_SECONDS,
        ));

    assert!(!test_bed.battery_contactor_is_closed());
}

完整的实现范例可参考共享库中的 battery_charge_limiter.rs:其 test_bed_with()(第 1185 行起)构建电池充电限制器测试床,然后用 .battery_bus_at_minimum_charging_voltage().and().battery_push_button_off().run(...) 这样的链式写法覆盖"电压阈值 + 225ms 延时 + 电门状态"的组合逻辑(例如第 1276-1312 行的三组对照测试)。

8. 单位无歧义 → uom crate

项目使用 uom(units of measurement)crate 处理单位,Ratio::new::<percent>(0.)、.get::<percent>() 这类写法贯穿所有代码。其设计意图是:让"磅与千克"这类换算错误、函数实参顺序传错等低级错误在编译期就被类型系统拦截。共享库 simulation/mod.rs 为 Velocity(knot)、Length(foot)、ThermodynamicTemperature(degree_celsius)、Ratio(percent)、ElectricPotential(volt)、ElectricCurrent(ampere)、Pressure(psi)、Volume(gallon)、Mass(pound) 等定义了默认读写单位,配套开发规范(guidelines.md)也要求:除非目标单位偏离 systems/src/simulation/mod.rs 中定义的默认单位,否则读写 uom 类型时不要显式转换单位,以保持代码简短易读。


五、一次完整 tick 的底层编排:Simulation::tick

把上面所有机制串起来的核心函数是共享库中的 Simulation::tick(simulation/mod.rs 第 435-466 行)。一次 tick 的编排顺序如下,恰好对应"读取 → 执行 → 写入"三阶段:

pub fn tick(&mut self, delta: Duration, simulation_time: f64, reader_writer: &mut impl SimulatorReaderWriter) {
    self.electricity.pre_tick();

    let mut reader = SimulatorReader::new(reader_writer);
    self.update_context.update(&mut reader, delta, simulation_time);   // 1. 读取:更新飞行环境上下文

    let mut visitor = SimulatorToSimulationVisitor::new(&mut reader);
    self.aircraft.accept(&mut visitor);                                // 1. 读取:SimulationElement.read 全部被调用

    self.aircraft.update_before_power_distribution(&self.update_context, &mut self.electricity);
    self.aircraft.distribute_electricity(&self.update_context, &self.electricity);
    self.aircraft.update_after_power_distribution(&self.update_context);
    self.aircraft.consume_electricity(&self.update_context, &mut self.electricity);
    self.aircraft.report_electricity_consumption(&self.update_context, &self.electricity);
                                                                       // 2. 执行:配电前后两阶段 + 耗电统计

    let mut writer = SimulatorWriter::new(reader_writer);
    let mut visitor = SimulationToSimulatorVisitor::new(&mut writer);
    self.aircraft.accept(&mut visitor);                                // 3. 写入:SimulationElement.write 全部被调用
}

可见,读与写都通过"同一架飞机、同一套 accept 访问者"完成,但访问者内部分别绑定 SimulatorReader 与 SimulatorWriter。这也解释了为什么模型代码只需要实现 read/write 两个方法、而完全不需要知道 SimConnect 的存在。此外还有 update_active_failures 通过 FailureSimulationElementVisitor 把激活故障集合广播给所有元素(对应 receive_failure 钩子),A380X 入口中那套庞大的故障编号表(21_xxx 空调、24_xxx 电气、26_xxx 火警、29_xxx 液压、32_xxx 起落架、34_xxx 导航)正是喂给它的。


六、配套开发规范要点(guidelines.md)

原文档要求开发者"阅读并持续跟进"同目录的 guidelines.md。该规范沉淀自 PR 评审意见,与本文的设计原则互为表里,值得提炼的核心条目包括:

  • Clippy 强制:绝大部分 Clippy 建议都被采纳;唯独 too_many_arguments 被全局禁用,因为真实飞机系统依赖众多,强行拆分参数结构反而会偏离现实。
  • 单位类型:尽量用 uom 单位类型而非裸数值;读写时除非偏离默认单位否则不做显式转换。
  • HashMap/HashSet:优先 rustc_hash::{FxHashMap, FxHashSet},其 hasher 显著更快。
  • 测试层级:优先做模块级/组合级(component/integration)测试,用 trait 模拟对电气等系统的依赖,让更多代码路径被断言覆盖;测试内的少量重复是可接受的,必要时在自定义 TestBed 上封装带描述性名字的函数。
  • 断言写法:用 assert_eq!/assert_ne! 而不是 assert!(a == b)。
  • 迪米特法则:禁止 foo.bar().baz() 式的链式取数。
  • 显式 match 模式:避免裸 _,让编译器在新增枚举变体时提醒你补全分支;无法完整枚举时(如数值类型)用 _ => panic!(...)。
  • 偏向单态化(monomorphisation):用类型参数而非 dyn,以运行期性能换取编译期开销。
  • 传递结构体而非拆开的数值:如 self.sfcc.update(context, &self.flaps_handle, &self.flap_gear) 优于逐值传递;接口参数优先 &impl SomeTrait;所有权可转移时优先 String 而非 &str + to_owned。
  • 不要重读 Rust 写出的 SimVars:Rust 代码写出的 SimVar(如 HYD_GREEN_PRESSURE)不应再被 Rust 代码通过 read 读回,而应直接传递持有该值的结构体(如 &impl PressureSource)。
  • 命名与风格:类型名用非缩写长名(AuxiliaryPowerUnit 而非 APU、ElectronicControlBox 而非 ECB;Arinc429Word 这类缩写反而更通行的除外);变量名视类型信息量选择缩写与否;拼写偏好英式英语;注释写在代码上方、以空格开头、遵循标点规则,避免 TODO 与注释掉的死代码。

七、总结:这套设计带来的实际收益

回到原文档的初衷——"良好的软件设计让新功能更容易实现"。把 A380X 系统的设计选择串起来看,收益是环环相扣的:

  1. 洋葱式分层 + Visitor 解耦 让 A380/A320 模型可以在 CI 里脱离 MSFS 高速回归,这正是"单元测试强制"能够成立的前提;
  2. 显式更新顺序 + 参数传递 把电气-APU 这类循环依赖摊平为确定性的阶段,保证单 tick 内状态一致;
  3. 共享 systems 库 + 构造参数注入差异 使 A320X 与 A380X 复用同一套仿真基础设施,差异收敛为机型模型与配置;
  4. uom 单位系统 + StartState 枚举 分别把"单位混淆"与"多阶段起动"两类高频错误挡在编译期之外。

因此,这篇 README 不只是 A380X 的开发说明,更是一份"如何在飞行模拟环境中构建可测试、可复用、状态一致的复杂系统仿真"的完整方法论。结合 a380_systems/src/lib.rs、a380_systems_wasm/src/lib.rs、simulation/mod.rs 与 simulation/test.rs 等源码继续阅读,你将看到这套设计在整机尺度上的完整落地。

登录后查看全文
aircraft