温馨提示×

Debian怎么解决Flutter依赖

小樊
47
2026-08-11 11:22:36
栏目: 智能运维

在 Debian 上解决 Flutter 依赖问题,通常分为 系统依赖Flutter SDK 本身、以及 构建/运行时的依赖 三部分。下面按常见场景给你一套完整、实用的解决方案。


一、先确认 Debian 版本

cat /etc/os-release

建议:

  • Debian 11 (Bullseye)Debian 12 (Bookworm)
  • 老版本(Debian 10 及以下)Flutter 支持不完整 ❌

二、安装 Flutter 所需的系统依赖(最关键)

Flutter 官方对 Linux 的依赖在 Debian 上不是自动满足的。

1️⃣ 基础编译工具

sudo apt update
sudo apt install -y \
  build-essential \
  curl \
  git \
  unzip \
  xz-utils \
  zip \
  libglu1-mesa

2️⃣ 图形 / GTK / 桌面相关(Linux 桌面 App 必须)

如果你要 运行或构建 Linux 桌面应用

sudo apt install -y \
  libgtk-3-dev \
  libblkid-dev \
  liblzma-dev \
  libstdc++-12-dev \
  pkg-config \
  cmake \
  ninja-build

⚠️ 缺少这些会导致:

  • flutter run
  • flutter build linux 直接失败

3️⃣ Android 开发依赖(如果你做 Android)

sudo apt install -y \
  openjdk-17-jdk \
  wget \
  lib32stdc++6 \
  lib32z1

设置 Java:

sudo update-alternatives --config java

三、正确安装 Flutter SDK(推荐方式)

1️⃣ 下载 Flutter

cd ~
git clone https://github.com/flutter/flutter.git -b stable

2️⃣ 加入 PATH

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

(如果你用 zsh)

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

3️⃣ 运行 doctor(最重要)

flutter doctor -v

✅ 正常情况会看到:

  • Flutter ✅
  • Dart ✅
  • Android toolchain ✅
  • Linux toolchain ✅

❌ 有任何红色 ×,按提示解决


四、常见 Debian 特有依赖问题 & 解决方案

❌ 问题 1:缺少 clang / cmake

CMake Error: CMake was unable to find a build program

✅ 解决:

sudo apt install clang cmake ninja-build

❌ 问题 2:Linux desktop not supported

Linux toolchain is not installed

✅ 解决:

sudo apt install libgtk-3-dev
flutter doctor

❌ 问题 3:Android license 问题

flutter doctor --android-licenses

如果报错:

sdkmanager --licenses

❌ 问题 4:依赖冲突(Debian 12)

有时 libstdc++ 版本问题:

✅ 解决:

sudo apt install libstdc++-12-dev

五、Flutter 项目依赖问题(pub)

1️⃣ 清理缓存

flutter clean
flutter pub cache repair

2️⃣ 重新拉依赖

flutter pub get

六、如果你用的是 Debian 无桌面(服务器)

不能运行 Linux GUI 应用

但可以:

  • ✅ 编译 Android APK
  • ✅ Web
  • ❌ Linux Desktop

七、总结(速查表)

# 系统依赖
sudo apt install build-essential git curl unzip xz-utils zip libglu1-mesa

# Linux 桌面
sudo apt install libgtk-3-dev cmake ninja-build

# Android
sudo apt install openjdk-17-jdk

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

如果你愿意,可以把 flutter doctor -v 的输出贴出来,我可以逐条帮你修 ✅

0