在 Linux 上安装 Flutter 开发环境

Flutter 是一个流行的开源 UI 软件开发工具包,被世界各地的开发人员用来从单个代码库构建适用于移动、Web 和桌面的原生编译应用程序。

在中国安装和使用 Flutter,请使用可信的 Flutter 镜像。这需要在你的机器上设置两个环境变量。以下所有示例均假定你正在使用 CFUG 的镜像。

系统要求

要安装并运行 Flutter,您的开发环境必须满足以下最低要求:

  • 操作系统: Linux (64-bit)
  • 磁盘空间: 600 MB (不包括 Android Studio 的磁盘空间).
  • 工具: Flutter 依赖下面这些命令行工具.

bash, mkdir, rm, git, curl, unzip, which

安装依赖项

安装 Flutter 的必要依赖项:

1
2
3

sudo dnf install bash curl file git unzip which xz zip mesa-libGLU clang cmake ninja-build pkg-config

使用镜像

由于在国内访问 Flutter 有时可能会受到限制,Flutter 官方为中国开发者搭建了临时镜像,大家可以将如下环境变量加入到用户环境变量中:

1
2
3
4
5
6
7
8

## 设置环境变量
cat <<EOF >> ~/.bashrc
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
EOF
source ~/.bashrc

获取Flutter SDK

需要flutter官网 SDK 版本列表 下载 Flutter, 在国内的网络环境,可以通过 Flutter 镜像下载。

Flutter的渠道版本会不停变动,请以Flutter官网为准。另外,在中国大陆地区,要想正常获取安装包列表或下载安装包,读者也可以去Flutter github项目下去下载安装包,转到下载页

现在 Flutter 镜像网站使用 wget 命令下载 Flutter SDK for Linux 的最新稳定版本:

1
2
3

wget -O /tmp/flutter_linux_3.35.7-stable.tar.xz https://storage.flutter-io.cn/flutter_infra_release/releases/stable/linux/flutter_linux_3.35.7-stable.tar.xz

将 flutter 安装包 解压到 /usr/local/(或您创建的任何其他目录):

1
2
3
4

sudo tar -xvJf /tmp/flutter_linux_3.35.7-stable.tar.xz -C /usr/local/


要全局使用 Flutter 命令,请将 Flutter 添加到您的系统路径:

1
2
3
4

echo 'export PATH=$PATH:/usr/local/flutter/bin' >> ~/.bashrc
source ~/.bashrc

验证flutter_distributor是否可用(使用缓存)

1
2
3
4
5
6
7
8
9
10
11

# 验证flutter_distributor是否可用
flutter pub global list | grep flutter_distributor

# 如果不可以则激活 flutter_distributor
dart pub global activate flutter_distributor

# 将缓存路径添加到环境变量
echo 'export PATH=$PATH:$HOME/.pub-cache/bin' >> ~/.bashrc
source ~/.bashrc

在 Linux 上运行 Flutter

安装 Flutter 后,通过运行 flutter doctor 命令来验证安装。此命令检查您的环境并显示 Flutter 安装状态的报告:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

user@server$ flutter doctor

Flutter assets will be downloaded from https://storage.flutter-io.cn. Make sure you trust this source!
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.35.7, on Fedora Linux 40 (Workstation Edition) 6.8.8-300.fc40.x86_64, locale
zh_CN.UTF-8)
[!] Android toolchain - develop for Android devices (Android SDK version 35.0.0)
✗ cmdline-tools component is missing.
Try installing or updating Android Studio.
Alternatively, download the tools from https://developer.android.com/studio#command-line-tools-only and
make sure to set the ANDROID_HOME environment variable.
See https://developer.android.com/studio/command-line for more details.
✗ Android license status unknown.
Run `flutter doctor --android-licenses` to accept the SDK licenses.
See https://flutter.dev/to/linux-android-setup for more details.
[✗] Chrome - develop for the web (Cannot find Chrome executable at google-chrome)
! Cannot find Chrome. Try setting CHROME_EXECUTABLE to a Chrome executable.
[✗] Linux toolchain - develop for Linux desktop
✗ GTK 3.0 development libraries are required for Linux development.
They are likely available from your distribution (e.g.: apt install libgtk-3-dev)
[✓] Android Studio (version 2022.3)
[✓] VS Code (version 1.93.0)
[✓] Connected device (1 available)
[✓] Network resources


参考文档

在 Linux 上搭建 Flutter 开发环境

在中国网络环境下使用 Flutter

设置您的 Flutter 环境

Flutter 学习(一):开发环境搭建

如何在 Fedora 39 上安装 Flutter

Install Flutter manually

在 Linux 上安装 Flutter 开发环境

https://pengtech.net/flutter/install_flutter.html

作者

鹏叔

发布于

2025-01-08

更新于

2025-11-07

许可协议

评论