Flutter：使用const修饰SwitchPreview时出现热重载异常显示问题

问题场景 #

以下代码可以正常生成带有黄色方块的阴影容器：

Container(
    padding: const EdgeInsets.only(top: 50),
    child: SwitchPreview(
        mode: enums.LayoutMode.template,
        orientation: enums.Orientation.vertical,
    ),
)

但给SwitchPreview添加const关键字后，出现异常：冷启动应用或VS重启时黄色方块不显示，执行保存触发热重载后才会显示；移除const关键字则一切正常。

问题原因 #

核心原因是const修饰的组件会在编译期创建不可变实例，所有依赖的配置、状态必须是编译期就能确定的常量。如果SwitchPreview内部存在依赖运行时数据、生命周期回调或动态状态的逻辑，加const后会导致组件在冷启动时初始化不完整，无法正确渲染；而热重载会重新执行组件的初始化流程，补上了冷启动时缺失的逻辑，因此能正常显示。

需要排查SwitchPreview的内容 #

• 构造函数是否标记为const：如果构造函数本身不是const，硬加const会导致编译期异常，但这里是运行时问题，更可能是构造函数是const，但内部成员初始化依赖了非const的运行时数据
• 生命周期方法逻辑：检查initState、didChangeDependencies中是否有依赖运行时上下文（如MediaQuery、Theme）或动态数据的初始化操作，const组件的生命周期执行时机与非const组件不同，冷启动时这些逻辑可能未触发
• 状态依赖情况：排查组件是否依赖了可变的外部状态（如ChangeNotifier、Provider），const组件的实例是固定不可变的，无法绑定或响应状态变化，热重载后重新创建实例才能正常关联状态
• build方法动态计算：检查build方法中是否有依赖运行时计算的参数（如动态尺寸、实时颜色值），const组件的build结果会复用编译期缓存，热重载才会重新执行计算并渲染
• 延迟初始化逻辑：查看组件内部是否有Future、WidgetsBinding.instance.addPostFrameCallback这类延迟执行的逻辑，const组件初始化时这些逻辑可能未正确触发，热重载后才会正常执行

内容的提问来源于stack exchange，提问作者developer82