在 Debian 上安装和使用 Flutter,整体是可行的,但确实有一些常见坑点,尤其和系统版本、依赖、桌面环境、权限有关。下面按「安装 → 运行 → 开发体验」给你梳理。
Flutter 官方要求:
✅ 建议:
cat /etc/os-release
如果是 Debian 10,建议升级或换系统。
Debian 默认是“极简系统”,经常缺:
sudo apt install -y \
curl git unzip xz-utils zip libglu1-mesa \
clang cmake ninja-build pkg-config \
libgtk-3-dev liblzma-dev libstdc++6
⚠️ 特别容易漏的:
libgtk-3-dev(Linux 桌面 App 必须)clang(引擎编译)pkg-configDebian 官方源里的 Flutter:
✅ 正确做法:
git clone https://github.com/flutter/flutter.git -b stable
export PATH="$PWD/flutter/bin:$PATH"
Android Studio 装完后:
~/Android/Sdk解决:
flutter config --android-sdk ~/Android/Sdk
Flutter 需要:
Debian 常见坑:
sudo apt install openjdk-17-jdk
java -version
插手机后:
flutter devices
看不到设备。
原因:
plugdev 组解决:
sudo usermod -aG plugdev $USER
然后重新登录
报错类似:
GTK not found
必须装:
sudo apt install libgtk-3-dev
Debian 12 + GNOME + Wayland:
可临时用 X11:
echo "export GDK_BACKEND=x11" >> ~/.bashrc
官方源在国内很慢。
✅ 设置镜像:
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
通常是:
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
| 坑 | 表现 | 解决 |
|---|---|---|
| 磁盘空间不足 | 编译失败 | ≥20GB |
| 杀毒/沙箱 | 构建慢 | 加白名单 |
| 多用户 | 权限混乱 | 单用户开发 |
| zsh/bash | PATH 丢失 | 写进 .bashrc |
如果你愿意,可以告诉我:
我可以直接给你一套可复制的一条龙命令。