Debian如何调试Flutter项目

在 Debian（或任何 Linux）上调试 Flutter 项目，通常包含 环境准备、运行调试、断点调试、日志调试、性能调试 等几个层面。下面按实际开发流程给你一个完整指南。

一、环境准备（Debian）

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

添加到 PATH：

echo 'export PATH="$PATH:$HOME/flutter/bin"' >> ~/.bashrc
source ~/.bashrc

3. 检查环境

flutter doctor

常见需要处理的：

• Android SDK（如果用 Android）
• Linux 桌面支持
• Chrome（Web 调试）

二、创建 / 打开 Flutter 项目

flutter create my_app
cd my_app

运行：

flutter run

三、调试方式详解

✅ 1. 命令行调试（最基础）

运行并查看日志

flutter run -v

常用快捷键（运行后）：

• r：热重载（Hot Reload）
• R：热重启（Hot Restart）
• q：退出
• d：分离（detach）
• w：显示 widget 树

✅ 2. 断点调试（推荐）

方式一：VS Code（最简单）

安装插件

• Flutter
• Dart

打开项目

code my_app

设置断点

在 Dart 代码行号左侧点击即可。

启动调试

• F5
• 或点击「Run and Debug」

支持：

• 断点
• 单步调试
• 变量查看
• Call Stack

✅ 这是 Debian 上调试 Flutter 最推荐方式

方式二：Android Studio / IntelliJ

sudo apt install android-studio

安装 Flutter / Dart 插件后：

• 点击 Debug
• 可直接断点调试

✅ 3. 日志调试（print / logger）

普通日志

print('debug info: $value');

高级日志（推荐）

flutter pub add logger

import 'package:logger/logger.dart';

final logger = Logger();

logger.d("debug");
logger.e("error");
logger.i("info");

查看日志：

flutter logs

✅ 4. Debug 模式 vs Release 模式

Debug 模式（默认）

flutter run

特点：

• 支持热重载
• 支持断点
• 性能较低

Release 模式（无调试）

flutter run --release

✅ 5. Widget 调试（UI 调试神器）

开启 Debug 标志

import 'package:flutter/rendering.dart';

void main() {
  debugPaintSizeEnabled = true;
  runApp(const MyApp());
}

效果：

• 显示 widget 边框
• 非常适合 UI 错位问题

✅ 6. Flutter DevTools（强烈推荐）

启动

flutter pub global activate devtools
flutter devtools

或在 VS Code 中：

• 打开命令面板
• Dart: Open DevTools

功能：

• Widget 树
• 性能分析
• 内存分析
• CPU Profiling
• 网络请求

✅ 7. 调试 Linux 桌面应用

启用 Linux 支持

flutter config --enable-linux-desktop
flutter create .

运行：

flutter run -d linux

如果用 GDB：

flutter build linux --debug
./build/linux/debug/bundle/my_app

✅ 8. 常见调试问题（Debian 特有）

1. flutter doctor 缺少 Linux 工具

sudo apt install libgtk-3-dev clang cmake ninja-build

2. VS Code 无法识别 Flutter

which flutter

确保 PATH 正确。

3. 中文输入法问题（Linux 桌面）

• 与调试无关，但常见
• 需要 fcitx / ibus 配置

总结（推荐流程）

✅ Debian 调试 Flutter 最佳实践

1. 用 VS Code + Flutter 插件
2. F5 启动调试
3. 打断点 + 看变量
4. 用 logger 打日志
5. 用 DevTools 分析 UI / 性能

如果你愿意，我也可以：

• 帮你 一步步配置 Debian + VS Code
• 给你一个 Flutter 调试示例项目
• 针对 Linux / Android / Web 单独讲调试技巧

你现在是在调试 Linux 桌面、Android 还是 Web？