Debian 上获取与使用 Flutter 资源的完整指南
一 安装与获取 Flutter SDK
- 方式一 手动下载并解压(通用、版本可控)
- 安装基础依赖:sudo apt update && sudo apt install -y git wget unzip xz-utils
- 下载 Linux 发行包(示例为 x86_64,其他架构请选择对应包):
wget https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.24.5-stable.tar.xz
- 解压到目标目录(如 /opt/flutter):tar -xf flutter_linux_3.24.5-stable.tar.xz -C /opt
- 配置环境变量(写入 ~/.bashrc 或 ~/.zshrc):echo ‘export PATH=“$PATH:/opt/flutter/bin”’ >> ~/.bashrc && source ~/.bashrc
- 验证:flutter doctor
- 方式二 使用 Snap(更省事,适合快速上手)
sudo apt install -y snapd && sudo snap install flutter --classic,完成后执行 flutter doctor 验证。
二 配置国内镜像加速资源获取
- 为提升 pub 包与 SDK 下载速度,添加镜像环境变量到 ~/.bashrc:
echo ‘export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub’ >> ~/.bashrc
echo ‘export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter’ >> ~/.bashrc
source ~/.bashrc
- 说明:镜像仅加速 Flutter 官方资源与 Dart 包索引/下载,不影响系统包管理。
三 获取项目依赖与引擎预取
- 进入项目根目录,获取依赖:flutter pub get(依据 pubspec.yaml 解析并下载包及其传递依赖)
- 升级依赖:flutter pub upgrade(遵循版本约束升级到允许的最新版本)
- 查看依赖详情:flutter pub info <package_name>
- 预取常用开发二进制与引擎:flutter precache(加快后续创建/运行与构建速度)
四 桌面运行与 Linux 依赖
- 启用 Linux 桌面支持:flutter config --enable-linux-desktop
- 安装 Linux 桌面构建依赖(Debian 11/12 常见):
sudo apt install -y clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc+±12-dev
- 创建并运行示例:flutter create hello_world && cd hello_world && flutter run(确保已连接可用设备或配置好桌面环境)
五 常见问题与处理
- 权限与运行身份:避免以 root 运行 flutter 工具,可能导致权限与文件所有权问题;建议使用普通用户开发。
- 架构支持提示:若使用 Linux ARM64(如部分设备),官方预编译包可能不可用,需从源码构建或使用其他渠道的 ARM64 构建。
- 环境校验:执行 flutter doctor 逐项修复缺失组件(如 Android SDK/Platform-Tools、Flutter/Dart 插件、构建工具 等),确保开发与构建链路完整。