初始化规则：防止意外收窄与未初始化

1. fleet 参数偏一格，常是初始化规则在作祟

标定 YAML 里 decimation: 2.9 被读进 int 后静默截成 2——比 crash 更坏，因为一切「能跑」。Widget w(); 是函数声明不是变量；int x = 3.7 静默收窄。机器人参数从 YAML 进 struct，初始化规则错一次，仿真与真机分叉。仿真里碰巧用整数 yaml，真机标定出浮点，问题才暴露——这类 bug 最耗 field 时间。

int w = 3.7 静默收窄；Widget w() 是函数声明不是变量——机器人参数从 YAML 进 struct，初始化规则错一次，整 fleet 参数偏一格。统一初始化 {} 是类型安全第一道门——窄化在编译期报错，别留给运行时发现。新成员加入 struct 时默认 {} 零/init，别依赖未定义行为「以前碰巧是零」。

2. 统一初始化与 designated

cpp

struct LidarConfig {
  double range_max{100.0};
  int layers{16};
  std::string frame_id{"lidar_link"};
};

LidarConfig cfg{ .range_max = 50.0, .layers = 32 };
// int x{3.7};  // 编译错误：窄化

机器人参数 struct 尽量 POD + brace init，与 ROS declare_parameter 默认值类型对齐。Jazzy 参数服务器把 double 读成 int 也会窄化——declare_parameter<double>("gain") 与 YAML gain: 2.0 须一致。C++20 designated initializer 可读性更好，但 member 有 ctor 时 aggregate 规则变复杂。

3. initializer_list 陷阱

cpp

std::vector<int> v{1, 2, 3};   // 三元素
std::vector<int> w(3, 1);      // 三个 1
std::vector<int> u{10};        // 单元素 10，不是 size-10

auto x{1.0}; 是 double；auto x = {1.0}; 是 initializer_list<double>——别混。Eigen Matrix3d m{Map} 走 list init 会踩坑；矩阵用 (3,3) 或 Matrix3d::Identity()。YAML 读 double 赋 int 前先校验范围再 static_cast，别依赖 silent truncate。参数 struct 初始化 code review 专看括号 vs brace。

4. 成员初始化顺序

按 声明顺序 构造，不是 ctor 初始化列表顺序——基类先于 member。头文件声明顺序决定初始化顺序；成员互相依赖时重排声明，别靠「列表里写在前」。继承类里 base 先于 member 初始化，违反顺序是 subtle UB 源。与 ctor 初始化列表顺序无关——这是常见 interview 题，也是 field bug 源。

5. 与参数 declare 对齐

参数 struct 从 node 构造时，每个字段对应一次 declare，类型一致：

cpp

struct LidarCfg {
  int decimation{1};
  double min_range{0.3};
  explicit LidarCfg(const rclcpp::Node& n)
    : decimation(n.declare_parameter<int>("decimation", 1)) {}
};

缺字段 -Wmissing-field-initializers 应报警；YAML→struct 单测覆盖缺键与窄化 case。Jazzy 参数服务器把 double 读成 int 时也会窄化——declare 类型与 YAML 一致。

6. 案例：decimation 静默截断

标定 YAML 写 decimation: 2.9，旧代码静默得 2——降采样比预期粗，特征匹配率掉点却无人怀疑配置。改成 brace init 加 explicit double 读入再 range check 后，非法值启动即 fail。比 field 跑一周再猜算法更便宜。标定 YAML 读 int 字段时，parser 层应拒绝非整数或 explicit round policy，别留给 struct init 时才暴露。

7. most vexing parse

Widget w(); 是函数声明。Widget w{}; 或 auto w = Widget{}; 明确。机器人参数 struct 统一 {} 初始化，缺字段编译器警告。窄化在标定参数里：int v{3.14}; 窄化报错——比 silent truncate 好。

8. 默认成员与未初始化

缺省 {} 的 POD 成员在部分路径下未初始化——release 随机行为。-Wmissing-field-initializers 与 clang-tidy member-init 在 CI 阻断。从 YAML merge 进 struct 时，未出现的键须落编译期默认，不是留 garbage。多环境 overlay（sim vs real）用不同 struct 默认值或 factory，别靠「忘了 init 碰巧是零」。

9. 与 fleet 标定流水线

标定产出写回 yaml 再读进 struct——整条链路上 narrowing 与 designated 规则一致。自动化标定脚本若输出浮点，下游 int 字段须 explicit round+range check，别 silent truncate。版本升级 struct 增字段时，旧 yaml 缺键应落默认并 log WARN，别 crash 也别 silent 零值当有效标定。

10. 验收

-Wnarrowing、-Wmissing-field-initializers 全开。
clang-tidy cppcoreguidelines-pro-type-member-init。
YAML→struct 单测覆盖缺字段、窄化、括号 vs brace 混淆。
改 init 风格后 CI 窄化警告全绿再合。

12. 与 code generation 的交叉

标定工具自动生成 struct init 代码时，生成器须输出 designated initializer 与 declare 一致类型——人工改 YAML 不改生成代码仍会分叉。生成物进 CI diff check；hand-edited struct 与 generated struct 禁止混在同一参数路径。仿真与真机 overlay 用不同 yaml 文件时，struct 默认值须显式区分 sim/real，别共用一份「碰巧为零」的未 init 成员。

PR 改 struct 默认值或 init 语法时，reviewer 对照 YAML 样例与 declare 类型。vector(3,1) vs {3,1} 混用是 recurring typo——diff 里一眼标红。新增字段必须 {} 默认，禁止裸成员留未 init。fleet 标定流水线输出浮点时，下游 int 字段 round policy 写进 schema，与 brace 窄化检查形成双保险。