编辑
2026-05-20
前端
00

目录

简介
前置准备:配置中国区镜像 (可选但推荐)
Windows 安装指南
macOS 安装指南
Linux (以 Debian/Ubuntu 为例) 安装指南

简介

Flutter 是 Google 开源的 UI 工具包,其核心理念是“一套代码,多端运行”。它最大的优势在于不依赖原生控件,而是通过自研的 Skia 图形引擎进行自主渲染,从而能提供接近原生的性能和高度的界面一致性。它使用简洁且支持异步编程的 Dart 语言进行开发。

以下是 Flutter 在 Windows、macOS 和 Linux 三大操作系统上的详细安装指南。

前置准备:配置中国区镜像 (可选但推荐)

在中国大陆安装 Flutter,建议为 SDK 和依赖包配置国内镜像站点,以确保下载速度和稳定性。

打开终端(Windows 使用 PowerShell 或 CMD)。

设置环境变量:根据你使用的操作系统,执行以下命令:

Windows (PowerShell):

powershell
[System.Environment]::SetEnvironmentVariable('PUB_HOSTED_URL', 'https://pub.flutter-io.cn', 'User') [System.Environment]::SetEnvironmentVariable('FLUTTER_STORAGE_BASE_URL', 'https://storage.flutter-io.cn', 'User')

macOS / Linux (终端):

bash
export PUB_HOSTED_URL="https://pub.flutter-io.cn" export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

Windows 安装指南

安装前置工具:

安装 Git for Windows。

(可选,用于构建Windows应用) 安装 Visual Studio 2022,在安装时务必勾选 “使用 C++ 的桌面开发” 工作负载。

下载与解压 SDK:

访问 Flutter 中文社区镜像网站 https://docs.flutter.cn/install/archive/ ,下载 Windows 版本的 SDK 压缩包。

将压缩包解压到你指定的文件夹,例如 C:\src\flutter。

配置环境变量(PATH):

右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。

在“用户变量”或“系统变量”中找到 Path 变量,并点击“编辑”。

点击“新建”,添加 Flutter SDK 的 bin 目录路径,例如 C:\src\flutter\bin。

验证安装:

打开一个新的 PowerShell 或 命令提示符 窗口。

执行 flutter doctor 命令,该命令会自动检查你缺少的依赖(如 Android SDK、IDE插件等)并给出提示。

macOS 安装指南

安装前置工具:

Xcode:从 Mac App Store 安装 Xcode。安装后,在终端运行 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 和 sudo xcodebuild -runFirstLaunch 来完成设置,这对于 iOS 和 macOS 开发是必须的。运行 sudo xcodebuild -license 同意其许可协议。

命令行工具:终端运行 xcode-select --install 以安装 Git 等命令行工具。

下载与解压 SDK:

从 Flutter SDK 归档页面 下载 macOS 版本的 SDK 压缩包。

将文件解压到你想要的目录,例如 ~/development/flutter。

配置环境变量(PATH):

打开终端,使用 nano 或 vim 编辑你的 Shell 配置文件。

如果你使用 zsh (macOS Catalina 及更新版本默认):

bash
nano ~/.zshrc

如果你使用 bash (较旧版本):

bash
nano ~/.bash_profile

在文件末尾添加以下行,将 bin 目录添加到 PATH 中:

bash
export PATH="$PATH:$HOME/development/flutter/bin"

保存文件(nano 中按 Ctrl+X,然后按 Y 并回车),并运行 source ~/.zshrc (或 source ~/.bash_profile) 使配置生效。

验证安装:

执行 flutter doctor 命令,检查环境状态。

Linux (以 Debian/Ubuntu 为例) 安装指南

安装前置工具:

在终端中执行以下命令以安装编译 Flutter 应用所必需的工具和库:

bash
sudo apt-get update -y && sudo apt-get upgrade -y sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa sudo apt-get install -y clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-12-dev

下载与解压 SDK:

从 Flutter SDK 归档页面 下载 Linux 版本的 SDK 压缩包。

将文件解压到用户目录,例如 ~/flutter:

bash
cd ~ tar -xvf ~/Downloads/flutter_linux_*.tar.xz

配置环境变量(PATH):

使用 nano 编辑你的 Shell 配置文件。

如果你使用 bash:

bash
nano ~/.bashrc

如果你使用 zsh:

bash
nano ~/.zshrc

在文件末尾添加以下行:

bash
export PATH="$PATH:$HOME/flutter/bin"

保存文件并运行 source ~/.bashrc (或 source ~/.zshrc) 使配置生效。

验证安装:

执行 flutter doctor 命令,检查环境状态。

通用下一步:完成安装与开发工具 无论使用哪个平台,在执行 flutter doctor 后,请根据其输出提示完成以下步骤:

安装开发工具:建议安装 Visual Studio Code,并在其扩展市场中安装 Flutter 和 Dart 插件。

安装 Android 开发环境:下载并安装 Android Studio,完成 Android SDK 的安装和许可。之后在终端执行 flutter doctor --android-licenses 接受许可。

安装 iOS 开发环境:(仅限 macOS) 通过 Xcode 完成 iOS 和 macOS 环境的配置。

如果这些步骤你都顺利完成了,接下来就可以创建你的第一个Flutter应用,开始跨平台开发的旅程啦~

本文作者:Weee

本文链接:

版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!