在 Debian 上跑 Flutter 常见报错大致分几类,下面按「最常见 → 解决思路」给你一个排错清单,你可以对照看是哪一种。
flutter 命令报错:command not found原因:Flutter 没加入 PATH
解决:
# 假设 flutter 在 ~/flutter
echo 'export PATH="$HOME/flutter/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
如果是 zsh:
echo 'export PATH="$HOME/flutter/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
✗ Android toolchain - develop for Android devices
解决:
flutter doctor --android-licenses
flutter config --android-sdk /path/to/android-sdk
✗ Linux toolchain is not installed
解决(Debian / Ubuntu):
sudo apt update
sudo apt install -y \
clang cmake ninja-build pkg-config libgtk-3-dev \
liblzma-dev libstdc++-12-dev
然后:
flutter config --enable-linux-desktop
flutter doctor
例如:
error while loading shared libraries
常见缺:
sudo apt install libssl-dev libclang-dev
sudo apt install openjdk-17-jdk
设置:
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
flutter config --enable-android
flutter clean
flutter pub get
若在国内,可配置镜像:
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
sudo apt install android-sdk-platform-tools-common
或:
sudo usermod -aG plugdev $USER
重新登录
请把以下任意一项贴出来:
flutter doctor -v 输出我可以一步一步帮你修到能跑起来 ✅