在 Debian 下运行 Flutter 常见的报错主要集中在 环境依赖、权限、Android SDK、GLIBC 版本、桌面/Web 支持 等方面。下面按常见场景 + 解决方案给你一个排查清单。
cat /etc/debian_version
uname -m
✅ 推荐:
Flutter 在 Debian 上不是开箱即用,需要手动装依赖。
sudo apt update
sudo apt install -y \
curl \
git \
unzip \
xz-utils \
zip \
libglu1-mesa \
clang \
cmake \
ninja-build \
pkg-config \
libgtk-3-dev \
libblkid-dev \
liblzma-dev \
libstdc++-12-dev
⚠️ 如果你是 Flutter 桌面(Linux)开发,这些非常重要。
cd ~
git clone https://github.com/flutter/flutter.git -b stable
然后加入 PATH:
echo 'export PATH="$HOME/flutter/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
验证:
flutter doctor
flutter doctor 报 Android license 错误Android license status unknown
✅ 解决:
flutter doctor --android-licenses
如果提示 sdkmanager not found:
export ANDROID_HOME=~/Android/Sdk
export PATH=$ANDROID_HOME/cmdline-tools/latest/bin:$PATH
然后重新执行。
常见原因:缺少 JDK
sudo apt install openjdk-17-jdk
验证:
java -version
version `GLIBC_2.34' not found
✅ 原因:
✅ 解决方案(任选):
gtk not found
✅ 解决:
sudo apt install libgtk-3-dev
然后:
flutter config --enable-linux-desktop
flutter create .
flutter run -d linux
Chrome not found
✅ 安装 Chromium:
sudo apt install chromium
启用 Web:
flutter config --enable-web
no devices found
✅ 解决:
sudo usermod -aG plugdev $USER
sudo apt install android-sdk-platform-tools
adb devices
然后 重新登录 或重启。
| Debian | Flutter | 建议 |
|---|---|---|
| Debian 11 | 最新 stable | ⚠️ 可能踩坑 |
| Debian 12 | 最新 stable | ✅ 推荐 |
| Debian 10 | 旧版 Flutter | ❌ 不推荐 |
flutter doctor -v
flutter --version
dart --version
java -version
你可以直接把 完整报错信息 发出来,比如:
flutter doctor -v 输出flutter run 时报的错我可以一步一步帮你定位 ✅