热重载快速更新UI且保留状态,冷重载实为重启应用并丢失状态;前者适用于Widget逻辑修改,后者用于main()、pubspec.yaml或原生配置变更。

在 VS Code 中进行 Flutter 开发时,热重载(Hot Reload)和冷重载(Cold Reload)是两个常被混淆但用途明确的功能。热重载用于快速更新 UI 和逻辑代码,不重启应用;冷重载本质是重启应用(即重新运行 main()),会丢失当前状态,但能反映全局配置、初始化逻辑或平台通道等热重载无法处理的变更。
热重载:改完即见,状态保留
热重载适用于修改 Widget 树、State 类中的 build 方法、方法体、变量值等纯 Dart 逻辑。它通过将新代码注入正在运行的 Dart VM 实现秒级更新,UI 状态(如文本框输入、页面滚动位置、Tab 页签)通常保持不变。
- 快捷键:Ctrl+S(保存)后自动触发(需开启
dart.previewHotReloadOnSave设置);或手动按 Ctrl+F5(Windows/Linux) / Cmd+Shift+R(macOS) - VS Code 底部状态栏会显示 “Performing hot reload…” 及成功提示
- 注意:热重载失败时(如修改了 StatefulWidget 的类名、添加/删除 required 参数),会自动 fallback 到热重启(Hot Restart)——它比冷重载轻量,但仍会重置 State,不等于冷重载
冷重载:实际是“重启应用”,非 VS Code 原生功能
VS Code 的 Flutter 插件本身没有名为 “Cold Reload” 的独立命令。所谓“冷重载”,实指停止当前调试会话并重新启动应用,等效于点击调试工具栏的 Stop → 再点 Run(绿色三角)。它会完全重建 Dart VM、执行 main()、重新初始化所有单例和服务,因此适合以下场景:
- 修改了
main.dart中的顶层逻辑(如初始化 Firebase、设置全局 ThemeMode) - 更改了
pubspec.yaml(如新增图片、字体、插件依赖)并已运行flutter pub get - 调整了原生平台代码(Android 的
AndroidManifest.xml或 iOS 的Info.plist) - 需要清除所有内存状态(比如调试 initState 行为或路由栈异常)
如何高效切换:推荐工作流
不必纠结术语,关键是根据修改内容选择合适操作:
- 只动 UI 或业务逻辑 → 保存即热重载(确保设置中启用了 Dart: Hot Reload On Save)
- 改了资源、配置或原生层 → 先 Ctrl+Shift+F5(重启调试会话),或点击顶部菜单 Debug → Restart Session
- 不确定该用哪个?观察控制台输出:热重载显示 “Recompiled X libraries”;冷重载(重启)会看到 “Application finished.” 后接 “Launching lib/main.dart…”
基本上就这些。热重载快而局限,冷重载(即重启)慢但彻底——选对方式,开发节奏才不会卡在等待上。










