在 Debian 上开发 Flutter,常见依赖和报错主要来自 系统库缺失、Android 工具链 和 权限/环境 三类。下面按「最小可用 → 常见坑 → 一键检查」给你整理。
sudo apt update
sudo apt install -y \
git curl wget unzip xz-utils \
libglu1-mesa libglu1-mesa-dev \
lib32stdc++6 libstdc++6 \
clang cmake ninja-build \
pkg-config libegl1-mesa-dev \
libxkbcommon-dev libgtk-3-dev \
libgl1-mesa-dev libgles2-mesa-dev
如果你是 Debian 12(bookworm),上面基本覆盖 99% 问题
sudo apt install -y \
libnss3 libxss1 libasound2 \
libgtk-3-0 libgdk-pixbuf2.0-0
如果跑 Linux 桌面 App,还建议:
sudo apt install -y \
libayatana-appindicator3-1
sudo apt install -y openjdk-17-jdk
验证:
java -version
推荐方式(最稳):
环境变量:
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
❌ cmdline-tools not installed
sdkmanager "cmdline-tools;latest"
❌ license not accepted
flutter doctor --android-licenses
flutter doctor
常见问题速查:
| 问题 | 解决 |
|---|---|
| Chrome not found | sudo apt install chromium |
| Linux toolchain incomplete | 看第一节 |
| Android toolchain | 装 JDK + SDK |
| Connected device none | 插真机开 USB 调试 |
libsqlite3.so 报错sudo apt install libsqlite3-dev
Failed to load GTKsudo apt install libgtk-3-dev
用 --user 装 Flutter,避免系统依赖冲突
flutter doctor -v
echo "----"
java -version
echo "----"
echo $ANDROID_HOME
你可以告诉我:
我可以直接帮你 精准定位依赖。