Debian 配置 Flutter 开发环境
一 准备系统与依赖
- 更新系统并安装构建与图形依赖,以及 Git、curl、unzip 等工具:
- sudo apt update && sudo apt upgrade -y
- sudo apt install -y clang cmake build-essential pkg-config libegl1-mesa-dev libxkbcommon-dev libgles2-mesa-dev libwayland-dev wayland-protocols git curl wget unzip
- 说明:Flutter 的桌面/Android 开发在 Linux 上需要这些底层图形与构建工具,缺少时会导致运行或构建失败。
二 安装 Flutter SDK
- 方式一 手动下载解压(通用、便于版本管理)
- 下载并解压到 /opt/flutter(路径可自定义):
- wget https://storage.googleapis.com/flutter_infra/releases/stable/linux/flutter_linux_$(uname -m).tar.xz
- sudo tar xf flutter_linux_$(uname -m).tar.xz -C /opt
- sudo mv /opt/flutter_linux_$(uname -m) /opt/flutter
- 将 Flutter 加入 PATH(写入当前用户的 shell 配置,如 ~/.bashrc 或 ~/.zshrc):
- echo ‘export PATH=“$PATH:/opt/flutter/bin”’ >> ~/.bashrc
- source ~/.bashrc
- 方式二 使用 Snap(更省事,适合快速上手)
- 安装 Snap(如未安装):sudo apt install -y snapd
- 安装 Flutter:sudo snap install flutter --classic
- 验证安装:flutter --version 与 flutter doctor(首次运行会进行环境自检)。
三 配置 Android 开发环境(可选,用于 Android 构建与调试)
- 安装 Android Studio(自带 Android SDK、Platform-Tools、模拟器):
- 下载 Linux 版压缩包,解压至 /opt/android-studio,执行安装向导,在设置中安装 Flutter 与 Dart 插件。
- 配置环境变量(写入 ~/.bashrc 或 ~/.zshrc):
- export ANDROID_SDK_ROOT=$HOME/Android/Sdk
- export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools
- export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin
- 接受 Android 许可协议并安装缺失组件:
- flutter doctor --android-licenses(一路 y 确认)
- flutter doctor(确认 Android 相关项均为勾选状态)
- 说明:Flutter 在 Android 开发时需要 Android SDK、Build-Tools、Platform-Tools 等组件,Android Studio 提供了一站式安装与配置入口。
四 国内镜像加速(可选,提升国内下载速度)
- 写入 ~/.bashrc 或 ~/.zshrc:
- export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
- export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter
- 使配置生效:source ~/.bashrc 或 source ~/.zshrc
- 说明:镜像主要用于 pub 包 与 Flutter SDK/引擎 的下载加速,能显著缩短首次安装与依赖拉取时间。
五 创建项目与运行
- 创建项目:flutter create my_app
- 进入目录:cd my_app
- 运行项目:flutter run(确保已连接设备或启动模拟器)
- 常用维护命令:
- 升级 SDK:flutter upgrade
- 获取依赖:flutter pub get
- 说明:首次运行会触发 Gradle 与依赖下载,保持网络与镜像配置可用可显著提速。