debian如何调试flutter

在 Debian 上调试 Flutter，通常分为环境准备、运行调试、工具使用、常见问题排查几个部分。下面按实用顺序说明。

一、Debian 上准备 Flutter 调试环境

1. 安装依赖

sudo apt update
sudo apt install -y git curl unzip xz-utils \
  libglu1-mesa libgstreamer1.0-0 libgstreamer-plugins-base1.0-0 \
  clang cmake ninja-build pkg-config libgtk-3-0 libblkid-dev \
  liblzma-dev libsqlite3-dev

如果你是 Flutter 桌面（Linux）开发，还需要：

sudo apt install -y libgtk-3-dev

2. 安装 Flutter SDK

cd ~
git clone https://github.com/flutter/flutter.git -b stable
export PATH="$HOME/flutter/bin:$PATH"
flutter doctor

建议把 PATH 写入 ~/.bashrc 或 ~/.zshrc。

3. 启用 Linux 桌面支持（可选）

flutter config --enable-linux-desktop
flutter doctor

二、运行与调试 Flutter 应用

1. 运行项目

flutter run

常用参数：

flutter run --debug        # 调试模式（默认）
flutter run --release
flutter run -d linux       # 指定平台

2. 使用 IDE 调试（推荐）

VS Code（最简单）

1. 安装 Flutter 和 Dart 插件
2. 打开项目
3. 按 F5 启动调试
4. 支持：
   • 断点
   • 热重载（Hot Reload）
   • 变量查看

Android Studio

• 安装 Flutter 插件
• 使用 Logcat / Debug 面板

三、命令行调试技巧

1. 查看日志

flutter logs

2. 打印调试信息

print('debug info');
debugPrint('debug info');

3. 使用 assert

assert(value != null, 'value is null');

四、性能与深层调试

1. 性能调试

flutter run --profile

然后：

• 按 P 显示性能图层
• 使用 DevTools

2. 打开 Flutter DevTools

flutter pub global activate devtools
flutter devtools

浏览器打开：

http://localhost:9100

功能包括：

• Widget Inspector
• CPU / Memory
• 性能图
• 网络请求

五、常见问题排查（Debian 特有）

1. flutter doctor 报错

flutter doctor -v

根据提示安装缺失依赖。

2. Linux 桌面无法运行

可能原因：

• 缺少 GTK 依赖
• 未启用 linux-desktop

解决：

flutter config --enable-linux-desktop
sudo apt install libgtk-3-dev

3. 字体或中文乱码

安装中文字体：

sudo apt install fonts-wqy-zenhei

4. 权限问题

避免用 root 运行 Flutter：

sudo chown -R $USER:$USER ~/flutter

六、推荐调试流程（总结）

1. flutter doctor 确保环境正常
2. flutter run 启动应用
3. VS Code + 断点调试
4. 性能问题用 DevTools
5. 日志用 flutter logs

如果你愿意，可以告诉我：

• 是 移动端 / Linux 桌面 / Web
• 报错信息或卡在哪一步

我可以给你更针对性的调试方案。