Debian系统Flutter热重载如何使用

Debian 上 Flutter 热重载使用指南

一 环境准备与设备连接

• 安装 Flutter SDK：从官网下载 Linux x64 压缩包，解压至如 ~/flutter，并将 ~/flutter/bin 加入 PATH（写入 ~/.bashrc 或 ~/.profile 并执行 source 使其生效）。完成后运行 flutter doctor 检查环境。
• 安装 Linux 依赖（桌面/模拟器常用）：
  sudo apt update && sudo apt install -y libgtk-3-dev libgconf-2-4 libasound2 libcap2 libxkbcommon-x11-0 libxcursor1 libxrandr2 libxss1 libxtst6 libatk1.0-0 libcups2 libgdk-pixbuf2.0-0 libglib2.0-0 libnss3 xauth xvfb
• 连接设备：
  • 真机：启用 USB 调试，在终端执行 flutter devices 确认已识别。
  • 模拟器：可使用 Android Emulator 或 桌面平台（如 Linux 桌面目标）。
• 启动应用：在项目根目录执行 flutter run，确保应用已在设备或模拟器上运行。

二 三种触发热重载的方式

• 终端快捷键：应用运行后，在启动应用的终端按下 r 键即可触发热重载（部分环境需要按 两次 r）。
• 命令行：在项目目录执行 flutter reload。
• 设备/开发者工具：在应用界面执行 摇一摇，或通过快捷键 Ctrl+Shift+P（macOS 模拟器为 Cmd+Shift+P）打开开发者工具，选择 Reload。

三 使用要点与常见问题

• 适用模式：热重载仅在 Debug 模式下可用（依赖 JIT）；Release 模式为 AOT，不支持热重载。
• 典型不支持或易失效的改动：类名变更、添加/删除顶级变量、全局/静态变量初始化改动、main 函数调整、initState 逻辑变更、枚举/泛型变更等，通常需要 Hot Restart 或重启应用。
• 失败处理：若热重载失败，使用 Reload/热重启 让应用重启并应用更改。
• 状态保留：热重载会尽量保持应用当前状态（如页面栈与输入内容），但并非所有状态都能被保留，遇到不一致可手动重启。

四 桌面平台与无界面环境的补充

• Linux 桌面目标：可直接运行 flutter run -d linux 启动应用，随后使用上述任一方式触发热重载。
• 无显示环境（如服务器/SSH）：需启用虚拟显示，例如使用 Xvfb：
  • 启动虚拟显示：Xvfb :99 -screen 0 1920x1080x24 &
  • 设置显示：export DISPLAY=:99
  • 运行应用：flutter run -d linux
    之后可在运行终端使用 r 或 flutter reload 触发热重载。