在 Debian 上运行 Flutter 应用出现闪退(crash / 一启动就退出),通常不是单一原因,而是环境或依赖问题。下面按最常见 → 较少见的顺序给你排查思路。
Flutter 在 Linux 上默认使用 GTK,缺库会直接闪退且无明显提示。
必装依赖(Debian / Ubuntu):
sudo apt update
sudo apt install -y \
libgtk-3-0 \
libblkid1 \
liblzma5 \
libstdc++6 \
libgdk-pixbuf2.0-0 \
libglib2.0-0 \
libpango-1.0-0 \
libcairo2
如果是 Flutter 3.x+:
sudo apt install -y \
libgtk-3-dev \
clang \
cmake \
ninja-build \
pkg-config
如果你在:
都可能闪退。
✅ 解决:
export GDK_BACKEND=x11
flutter run
新项目容易忘了开启 Linux 支持。
flutter create .
flutter config --enable-linux-desktop
flutter run -d linux
flutter run -d linux
或编译后直接运行:
cd build/linux/x64/release/bundle
./yourapp
常见错误:
error while loading shared librariesGTK failed to initializeSegmentation faultdmesg | tail
或
journalctl -xe
在虚拟机或老机器上常见。
尝试:
export LIBGL_ALWAYS_SOFTWARE=1
flutter doctor -v
flutter clean
flutter pub get
例如:
检查:
flutter pub deps
如果你愿意,可以把:
flutter doctor -v发给我,我可以直接帮你定位到具体原因。