从零开始：Flutter 开发环境搭建全指南

雨季6662025-12-30 8:19

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
  1. 访问 Flutter 官方下载页：https://flutter.dev/docs/get-started/install/windows
  2. 下载最新稳定版 Flutter SDK 压缩包（flutter_windows_xxx-stable.zip）。
  3. 解压到自定义目录（建议非中文、无空格路径，如 D:\flutter）。
步骤 2：配置系统环境变量
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
  2. 用户变量 中，找到「Path」→「编辑」→「新建」，添加 Flutter 工具路径：D:\flutter\bin（对应解压路径）。
  3. 系统变量 中，新建变量：
    • 变量名：FLUTTER_STORAGE_BASE_URL，变量值：https://storage.flutter-io.cn（国内镜像，加速下载）
    • 变量名：PUB_HOSTED_URL，变量值：https://pub.flutter-io.cn（国内镜像）
  4. 保存后，重启命令行工具（CMD/PowerShell）使配置生效。
步骤 3：安装 Android Studio
  1. 下载 Android Studio：https://developer.android.com/studio
  2. 安装时勾选「Android SDK」「Android Virtual Device」，默认路径即可（避免中文）。
  3. 启动 Android Studio，完成初始化（需下载 SDK 组件，耐心等待）。
  4. 安装 Flutter 插件：
    • 打开「File」→「Settings」→「Plugins」。
    • 搜索「Flutter」，点击「Install」，安装完成后重启 IDE。
    • 插件会自动提示安装 Dart 插件（Flutter 依赖 Dart，必须安装）。
步骤 4：配置 Android 环境
  1. 打开 Android Studio →「Tools」→「SDK Manager」。
  2. 在「SDK Platforms」中，勾选至少一个 Android 版本（建议最新稳定版，如 Android 14）。
  3. 在「SDK Tools」中，勾选「Android SDK Build-Tools」「Android Emulator」「Android SDK Platform-Tools」，点击「Apply」下载。
  4. 配置 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：安装依赖工具

  1. 安装 Homebrew（包管理器）：

    复制代码 
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. 安装 Git 和 Ruby（CocoaPods 依赖）：

    复制代码 
    brew install git ruby
步骤 2：下载并配置 Flutter SDK

  1. 下载 Flutter SDK：https://flutter.dev/docs/get-started/install/macos

  2. 解压到自定义目录（如 ~/development/flutter）。

  3. 配置环境变量（zsh 终端，默认 macOS 10.15+ 为 zsh）：

    复制代码 
    # 编辑 ~/.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 终端，编辑 ~/.bash_profile，步骤同上）

步骤 3：安装 Xcode（iOS 开发必需）

  1. 从 App Store 下载 Xcode（需登录 Apple ID）。

  2. 打开 Xcode，同意许可协议，安装 Command Line Tools：

    复制代码 
    xcode-select --install

  3. 配置 Xcode 命令行工具路径：

    复制代码 
    sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

  4. 安装 CocoaPods（iOS 依赖管理工具）：

    复制代码 
    sudo gem install cocoapods
步骤 4：安装 Android Studio（Android 开发）
  1. 下载并安装 Android Studio：https://developer.android.com/studio
  2. 安装 Flutter 和 Dart 插件（同 Windows 步骤）。
  3. 配置 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

  1. 下载 Flutter SDK：https://flutter.dev/docs/get-started/install/linux

  2. 解压到 ~/flutter 目录：

    复制代码 
    unzip flutter_linux_xxx-stable.zip -d ~/

  3. 配置环境变量：

    复制代码 
    # 编辑 ~/.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

  1. 下载 Android Studio 压缩包，解压并安装：

    复制代码 
    sudo dpkg -i android-studio-xxx.deb

  2. 后续插件安装、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：

  1. 下载 VS Code：https://code.visualstudio.com/
  2. 安装 Flutter 插件：打开 VS Code → 扩展商店 → 搜索「Flutter」→ 安装（自动包含 Dart 插件）。
  3. 配置 Flutter 路径：VS Code → 设置 → 搜索「Flutter SDK Path」→ 填写 Flutter 解压路径（如 D:\flutter）。
  4. 验证：打开终端 → 执行 flutter doctor，确认无报错。

五、总结

Flutter 环境搭建核心是「SDK 配置 + 平台依赖（Android/iOS） + IDE 插件」，不同系统的差异主要在环境变量和平台工具（如 Xcode 仅 macOS 需安装）。搭建完成后，通过 flutter doctor 排查问题，通过创建示例项目验证可用性，即可开始 Flutter 开发之旅。

如果遇到特定问题，可参考 Flutter 官方文档（https://flutter.dev/docs/get-started/install）或社区问答（Stack Overflow/Flutter 中文网）。

相关推荐
爸爸6192 小时前
Flutter StatusBar Color NS 在鸿蒙平台的使用指南
flutter·华为·harmonyos
程序员老刘·2 小时前
Flutter版本选择指南：3.38.5 补丁发布，生产环境能上了吗？ | 2025年12月
flutter
w139548564222 小时前
Flutter跨平台照片搜索库desktop_photo_search鸿蒙化使用指南
flutter·华为·harmonyos
2501_9444460013 小时前
Flutter&OpenHarmony文件夹管理功能实现
android·javascript·flutter
kirk_wang15 小时前
Flutter三方库在OHOS平台适配实践：wakelock屏幕唤醒管理
flutter·移动开发·跨平台·arkts·鸿蒙
2501_9462338916 小时前
Flutter与OpenHarmony应用设置页面完整开发
android·flutter
2501_9444417516 小时前
Flutter&OpenHarmony商城App商品分类导航组件开发
flutter
程序员老刘17 小时前
Flutter版本选择指南：3.38.5 补丁发布，生产环境能上了吗？ | 2025年12月
flutter·客户端
纟 冬18 小时前
Flutter & OpenHarmony 运动App运动数据同步组件开发
flutter
热门推荐
01GitHub 镜像站点02从快手“12·22”直播攻击事件看：一次教科书式的业务层饱和攻击03Linux下V2Ray安装配置指南04电脑检测软件—图吧工具箱05Claude Code Skills 实用使用手册06jdk21下载、安装（Windows、Linux、macOS）07UV安装并设置国内源08BongoCat - 跨平台键盘猫动画工具09Web安全中SQL注入绕过WAF的具体手法和实战案例10SQLmap 完整使用指南：环境搭建 + 命令详解 + 实操案例