最省事方式是用 snap install flutter --classic,自动配置路径和权限;手动安装需正确解压、设置 PATH(注意 ~ 不展开、shell 匹配、无空格路径)、赋执行权限;国内需配置 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 镜像源。

Linux 上用 snap 安装 Flutter 最省事
如果你用的是 Ubuntu 或已启用 Snap 的主流发行版(如 Fedora、Debian 12+),直接运行 snap install flutter --classic 就能完成 SDK 安装,无需手动解压、配路径、改环境变量。安装后 flutter --version 立刻可用,flutter doctor 也能直接执行。
注意:Snap 版本默认绑定在 /snap/flutter/current/bin/,系统会自动注册该路径;但部分终端(比如用 tmux 或自定义 shell)可能需重启或运行 source /etc/profile 才识别命令。
手动安装时路径和权限最容易出错
手动下载 flutter_linux_3.xx.x-stable.tar.xz 解压后,必须把 flutter/bin 加进 PATH,且不能漏掉 export 声明。常见翻车点:
-
~/.bashrc里写了export PATH="$PATH:~/flutter/bin",但~在引号里不会展开 → 改成$HOME或写绝对路径 - 用了
zsh却去改.bashrc→ 查看echo $SHELL,对应编辑~/.zshrc - 解压目录含空格或中文(如
~/My Projects/flutter)→flutter doctor会报Failed to download tool类错误 - 没给
flutter/bin下文件可执行权限 → 运行chmod +x ~/flutter/bin/*
flutter doctor 报 Android 相关错误怎么快速过
Linux 下 flutter doctor -v 常见红字集中在 Android 工具链。不用硬啃官方文档,按顺序处理这三步基本清空:
- 装好
android-studio(推荐也用snap install android-studio --classic,路径干净无空格) - 启动一次 Android Studio,让它自动下载 SDK Platform-Tools、SDK Build-Tools 和 Android SDK 34(最低要求)
- 运行
flutter doctor --android-licenses,遇到卡住或Exception in thread "main"→ 先确认java -version输出是 JDK 17(不是 JRE 或 OpenJDK 21),再重试
如果只开发 Web 或桌面端,可跳过 Android 配置,但得加 --no-android 参数跑 flutter doctor,否则它一直标红。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq(Cortex‑A9/A53 + FPGA)Linux 环境,调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查,支持 PetaLinux 开发。
国内网络下不配镜像,flutter pub get 会卡死
即使 SDK 装好了,首次 flutter create 或 pub get 仍大概率失败——因为默认源 https://pub.dev 和存储桶被墙。必须设两个环境变量:
在 ~/.zshrc 或 ~/.bashrc 末尾加:
export PUB_HOSTED_URL=https://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
然后 source ~/.zshrc。验证方式:删掉项目里的 .packages 和 pubspec.lock,再跑一次 flutter pub get,看到 “Resolving dependencies…” 后快速滚动就对了。
镜像不是万能的——iOS 构建(flutter build ios)在 Linux 上根本不可行,Xcode 只跑在 macOS 上;这点容易被忽略,尤其刚从 Windows/macOS 切过来的人。

















