Flutter 是 Google 推出的跨平台 UI 开发框架，可快速构建高性能、跨 iOS 和 Android 的原生应用。本文将详细讲解不同操作系统（Windows/macOS/Linux）下 Flutter 环境的完整搭建流程，涵盖基础配置、IDE 选型、环境验证等核心步骤，帮助新手快速上手。
一、搭建前的准备
1. 硬件要求
| 系统 | 最低配置要求 |
|---|---|
| Windows | Windows 10/11 64 位、4GB 以上内存、开启硬件虚拟化（VT-x/AMD-V）、磁盘空间 ≥ 10GB |
| macOS | macOS 12+、Intel/Apple Silicon 芯片、4GB 以上内存、磁盘空间 ≥ 10GB |
| Linux | Ubuntu 20.04+/Debian 11+ 64 位、4GB 以上内存、磁盘空间 ≥ 10GB |
2. 软件依赖
- Git：用于克隆 Flutter 源码和版本控制（下载地址）
- Java Development Kit (JDK)：建议 JDK 17（Android 开发必需，下载地址）
- Android Studio（可选但推荐）：集成 Android SDK、模拟器，支持 Flutter 开发
- Xcode（仅 macOS）：iOS/iPadOS 开发必需，需 App Store 下载或开发者官网获取
二、分系统搭建步骤
（一）Windows 系统
步骤 1：下载 Flutter SDK
- 访问 Flutter 官方下载页：https://flutter.dev/docs/get-started/install/windows
- 下载最新稳定版 Flutter SDK 压缩包（flutter_windows_xxx-stable.zip）。
- 解压到自定义目录（建议非中文、无空格路径，如
D:\flutter）。
步骤 2：配置系统环境变量
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
- 用户变量中，找到「Path」→「编辑」→「新建」，添加 Flutter 工具路径：
D:\flutter\bin（对应解压路径）。 - 系统变量中，新建变量：
- 变量名：
FLUTTER_STORAGE_BASE_URL，变量值：https://storage.flutter-io.cn（国内镜像，加速下载） - 变量名：
PUB_HOSTED_URL，变量值：https://pub.flutter-io.cn（国内镜像）
- 变量名：
- 保存后，重启命令行工具（CMD/PowerShell）使配置生效。
步骤 3：安装 Android Studio
- 下载 Android Studio：https://developer.android.com/studio
- 安装时勾选「Android SDK」「Android Virtual Device」，默认路径即可（避免中文）。
- 启动 Android Studio，完成初始化（需下载 SDK 组件，耐心等待）。
- 安装 Flutter 插件：
- 打开「File」→「Settings」→「Plugins」。
- 搜索「Flutter」，点击「Install」，安装完成后重启 IDE。
- 插件会自动提示安装 Dart 插件（Flutter 依赖 Dart，必须安装）。
步骤 4：配置 Android 环境
- 打开 Android Studio →「Tools」→「SDK Manager」。
- 在「SDK Platforms」中，勾选至少一个 Android 版本（建议最新稳定版，如 Android 14）。
- 在「SDK Tools」中，勾选「Android SDK Build-Tools」「Android Emulator」「Android SDK Platform-Tools」，点击「Apply」下载。
- 配置 Android SDK 环境变量：
- 系统变量中新建
ANDROID_HOME，值为 SDK 路径（如C:\Users\用户名\AppData\Local\Android\Sdk）。 - Path 中添加
%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools\bin。
- 系统变量中新建
（二）macOS 系统
macOS 需同时支持 iOS 和 Android 开发，步骤如下：
步骤 1：安装依赖工具
- 安装 Homebrew（包管理器）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装 Git 和 Ruby（CocoaPods 依赖）：
brew install git ruby
步骤 2：下载并配置 Flutter SDK
- 下载 Flutter SDK：https://flutter.dev/docs/get-started/install/macos
- 解压到自定义目录（如
~/development/flutter）。 - 配置环境变量（zsh 终端，默认 macOS 10.15+ 为 zsh）：
（若为 bash 终端，编辑# 编辑 ~/.zshrc 文件 open ~/.zshrc # 添加以下内容 export PATH="$PATH:~/development/flutter/bin" export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn export PUB_HOSTED_URL=https://pub.flutter-io.cn # 生效配置 source ~/.zshrc~/.bash_profile，步骤同上）
步骤 3：安装 Xcode（iOS 开发必需）
- 从 App Store 下载 Xcode（需登录 Apple ID）。
- 打开 Xcode，同意许可协议，安装 Command Line Tools：
xcode-select --install - 配置 Xcode 命令行工具路径：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer - 安装 CocoaPods（iOS 依赖管理工具）：
sudo gem install cocoapods
步骤 4：安装 Android Studio（Android 开发）
- 下载并安装 Android Studio：https://developer.android.com/studio
- 安装 Flutter 和 Dart 插件（同 Windows 步骤）。
- 配置 Android SDK（同 Windows 步骤），macOS 下 SDK 路径默认：
~/Library/Android/sdk。
（三）Linux 系统（以 Ubuntu 为例）
步骤 1：安装依赖
sudo apt update sudo apt install -y git curl unzip openjdk-17-jdk步骤 2：下载并配置 Flutter SDK
- 下载 Flutter SDK：https://flutter.dev/docs/get-started/install/linux
- 解压到
~/flutter目录：unzip flutter_linux_xxx-stable.zip -d ~/ - 配置环境变量：
# 编辑 ~/.bashrc nano ~/.bashrc # 添加内容 export PATH="$PATH:~/flutter/bin" export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn export PUB_HOSTED_URL=https://pub.flutter-io.cn # 生效 source ~/.bashrc
步骤 3：安装 Android Studio
- 下载 Android Studio 压缩包，解压并安装：
sudo dpkg -i android-studio-xxx.deb - 后续插件安装、SDK 配置同 Windows 步骤。
三、环境验证与问题修复
1. 基础验证
打开终端 / CMD，执行以下命令，检查 Flutter 环境：
flutter doctor该命令会检测所有依赖项，并输出问题提示（红色 × 为未配置项，黄色！为警告）。
2. 常见问题修复
- 问题 1：Android license status unknown（Android 许可未同意）解决：执行
flutter doctor --android-licenses，一路输入y同意所有许可。 - 问题 2：iOS 模拟器无法启动（macOS）解决：打开 Xcode →「Preferences」→「Components」，下载对应 iOS 版本的模拟器。
- 问题 3：Flutter 命令找不到解决：重新检查环境变量配置，确保 Flutter 的 bin 目录已添加到 Path。
- 问题 4：国内下载依赖慢 / 失败解决：确认已配置 Flutter 国内镜像（FLUTTER_STORAGE_BASE_URL 和 PUB_HOSTED_URL），或使用代理。
3. 最终验证
创建第一个 Flutter 项目，验证环境是否可用：
# 创建项目 flutter create my_first_app # 进入项目目录 cd my_first_app # 运行项目（需启动模拟器或连接真机） flutter run若模拟器 / 真机中成功显示 Flutter 示例页面，说明环境搭建完成。
四、可选配置：VS Code 开发
若不想使用 Android Studio，可选择轻量的 VS Code：
- 下载 VS Code：https://code.visualstudio.com/
- 安装 Flutter 插件：打开 VS Code → 扩展商店 → 搜索「Flutter」→ 安装（自动包含 Dart 插件）。
- 配置 Flutter 路径：VS Code → 设置 → 搜索「Flutter SDK Path」→ 填写 Flutter 解压路径（如
D:\flutter）。 - 验证：打开终端 → 执行
flutter doctor，确认无报错。
五、总结
Flutter 环境搭建核心是「SDK 配置 + 平台依赖（Android/iOS） + IDE 插件」，不同系统的差异主要在环境变量和平台工具（如 Xcode 仅 macOS 需安装）。搭建完成后，通过flutter doctor排查问题，通过创建示例项目验证可用性，即可开始 Flutter 开发之旅。
如果遇到特定问题，可参考 Flutter 官方文档（https://flutter.dev/docs/get-started/install）或社区问答（Stack Overflow/Flutter 中文网）。
