Debian怎样调试Flutter

在 Debian 上调试 Flutter，通常分为 开发环境准备、运行与日志调试、IDE 调试、性能与底层问题排查 几个层面。下面给你一套比较完整的实践指南。

一、Debian 上准备 Flutter 开发环境

1. 安装依赖

sudo apt update
sudo apt install -y \
  curl \
  git \
  unzip \
  xz-utils \
  zip \
  libglu1-mesa \
  clang \
  cmake \
  ninja-build \
  pkg-config \
  libgtk-3-dev

2. 安装 Flutter SDK

cd ~
git clone https://github.com/flutter/flutter.git -b stable
echo 'export PATH="$HOME/flutter/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

验证：

flutter doctor

二、运行与基础调试

1. 创建并运行项目

flutter create demo
cd demo
flutter run

在 Debian 上默认是 Linux 桌面应用。

2. 常用运行参数

flutter run --verbose        # 查看详细日志
flutter run --release        # release 模式
flutter run --profile        # 性能分析模式

三、日志与错误调试

1. Dart 层日志

print('debug info');

或使用日志库：

import 'dart:developer';
log('debug message');

终端查看：

flutter logs

2. Flutter 崩溃 / 白屏

flutter run --verbose

重点看：

• Error: / Exception:
• MissingPluginException
• Failed to load dynamic library

四、使用 IDE 调试（推荐）

1. VS Code（最常用）

sudo apt install code

安装插件：

• Flutter
• Dart

调试方式：

• 打开项目
• F5 启动调试
• 可打断点、查看变量、调用栈

2. Android Studio / IntelliJ

sudo apt install android-studio

安装 Flutter / Dart 插件
支持：

• 断点调试
• Widget Inspector
• 内存分析

五、Linux 桌面特有调试

1. GTK / 窗口问题

export GDK_BACKEND=x11
flutter run

或 Wayland：

export GDK_BACKEND=wayland

2. 动态库缺失（常见）

报错示例：

cannot open shared object file

解决：

sudo apt install libsqlite3-dev libsecret-1-dev

六、性能与底层调试

1. 性能调试

flutter run --profile

打开：

• Performance Overlay
• DevTools

启动 DevTools：

flutter pub global activate devtools
flutter devtools

浏览器访问：

http://localhost:9100

2. 原生 Linux 调试

cd linux
cmake .
make
./flutter_demo

可用：

gdb ./flutter_demo

七、常见问题排查

1. flutter doctor 报错

• clang / cmake 缺失 → 安装编译工具
• Android 工具链 → 不需要（Linux 桌面可不装）

2. 中文 / 字体问题

sudo apt install fonts-noto-cjk

3. 权限问题

不要使用 root 运行 Flutter：

whoami   # 应为普通用户

八、推荐调试流程（实战）

1. flutter doctor 确保环境正常
2. flutter run --verbose
3. VS Code 打断点调试 Dart
4. 性能问题 → DevTools
5. Linux 原生问题 → GDK_BACKEND / gdb

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

• 是 Linux 桌面 / Android / Web？
• 报错日志或现象（白屏、闪退、卡顿）？

我可以直接帮你定位具体问题。