温馨提示×

Debian装Flutter有哪些坑

小樊
35
2026-09-22 07:22:30
栏目: 智能运维

在 Debian 上安装和使用 Flutter,整体是可行的,但确实有一些常见坑点,尤其和系统版本、依赖、桌面环境、权限有关。下面按「安装 → 运行 → 开发体验」给你梳理。


一、安装阶段常见坑

1. 系统版本太老(最常见)

Flutter 官方要求:

  • Debian 11(bullseye)及以上 才比较稳
  • Debian 10 及以下:glibc 版本不够,容易直接跑不起来

✅ 建议:

cat /etc/os-release

如果是 Debian 10,建议升级或换系统。


2. 缺少基础依赖(flutter doctor 报错)

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-config

3. 直接用 apt 装 Flutter(不推荐)

Debian 官方源里的 Flutter:

  • 版本极老
  • 经常和 Dart / Android SDK 不兼容

✅ 正确做法:

git clone https://github.com/flutter/flutter.git -b stable
export PATH="$PWD/flutter/bin:$PATH"

二、Android 开发相关坑(最多人卡这里)

4. Android SDK 在 Debian 上路径问题

Android Studio 装完后:

  • SDK 默认在 ~/Android/Sdk
  • Flutter 经常找不到

解决:

flutter config --android-sdk ~/Android/Sdk

5. 没有设置 JDK(或版本错)

Flutter 需要:

  • JDK 17(Android 开发推荐)

Debian 常见坑:

  • 默认 JDK 11
  • 或装了多个 JDK 没切换
sudo apt install openjdk-17-jdk
java -version

6. 真机调试权限问题

插手机后:

flutter devices

看不到设备。

原因:

  • 用户不在 plugdev 组
  • udev 规则没配

解决:

sudo usermod -aG plugdev $USER

然后重新登录


三、Linux 桌面(Flutter Desktop)坑

7. 编译 Linux App 直接失败

报错类似:

GTK not found

必须装:

sudo apt install libgtk-3-dev

8. Wayland 下显示异常

Debian 12 + GNOME + Wayland:

  • 部分 Flutter 桌面程序字体模糊
  • 或弹窗位置错误

可临时用 X11:

echo "export GDK_BACKEND=x11" >> ~/.bashrc

四、网络和镜像坑(国内用户必看)

9. pub get 卡死

官方源在国内很慢。

✅ 设置镜像:

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

10. flutter doctor 一直卡在“Checking network”

通常是:

  • 被墙
  • 或代理没配置
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

五、其他小坑总结

坑 表现 解决
磁盘空间不足 编译失败 ≥20GB
杀毒/沙箱 构建慢 加白名单
多用户 权限混乱 单用户开发
zsh/bash PATH 丢失 写进 .bashrc

六、推荐最小可用环境(Debian 12)

  • Debian 12 (bookworm)
  • GNOME + X11
  • OpenJDK 17
  • Android Studio + SDK
  • Flutter stable(git 安装)

如果你愿意,可以告诉我:

  • Debian 版本
  • 是否做 Android / Linux 桌面 / Web
  • 是否在国内

我可以直接给你一套可复制的一条龙命令。

0 踩