Flutter开发环境配置完整教程

Question

Flutter环境配置完整指南

Flutter作为Google推出的跨平台UI框架，配置开发环境是开始Flutter开发的第一步。本文将详细介绍Flutter环境配置的完整流程，包括系统要求、SDK安装、环境变量设置、开发工具集成等。

系统环境要求

Windows系统

操作系统：Windows 7 SP1或更高版本（64位）
磁盘空间：至少400MB可用空间
工具依赖：需要PowerShell 5.0及以上版本，以及Git for Windows

macOS系统

操作系统：macOS 10.14或更高版本
磁盘空间：建议至少3GB（包含Android Studio安装）
命令行工具：需要bash、git、curl等基础工具

SDK安装与配置

安装方式

GitHub克隆（推荐）

git clone -b stable https://github.com/flutter/flutter.git

推荐使用 stable 分支以获取稳定版本
解压路径应避免系统保护目录，如 C:\Program Files

直接下载

从Flutter官网下载对应系统的压缩包，解压后进行配置。

环境变量设置

Windows配置

添加Flutter路径到 PATH 环境变量：
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
- 在用户变量 PATH 中添加Flutter的 bin 目录路径，例如 C:\src\flutter\bin
配置国内镜像加速以提高下载速度：

$env:PUB_HOSTED_URL = "https://pub.flutter-io.cn"
$env:FLUTTER_STORAGE_BASE_URL = "https://storage.flutter-io.cn"

macOS配置

编辑 ~/.bash_profile 或 ~/.zshrc 文件：

export PATH="$PATH:/path/to/flutter/bin"
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

执行 source ~/.bash_profile 使配置生效。

开发工具集成

Android Studio配置

安装最新版Android Studio。
安装必要插件：
- Flutter插件：在 File → Settings → Plugins 中搜索并安装。
- Dart插件：通常随Flutter插件自动安装。
配置Android SDK：启动Android Studio，进入 SDK Manager 安装最新SDK和构建工具。

VSCode配置

安装最新版VSCode。
安装插件：通过扩展市场搜索并安装 Flutter 和 Dart 插件。
验证配置：打开命令面板（快捷键 Ctrl+Shift+P），输入 Flutter: Run Flutter Doctor 进行检查。

环境验证与诊断

运行以下命令检查配置是否成功：

flutter doctor

输出示例如下：

[√] Flutter (Channel stable, v1.12.13+hotfix.9)
[√] Android toolchain - develop for Android devices
[√] Android Studio (version 3.6)
[!] Connected device
    ! No devices available

常见问题处理：

Android工具链缺失：安装Android Studio并正确配置SDK。
许可证未接受：运行 flutter doctor --android-licenses 接受许可证。
网络问题：确保网络可以访问国内镜像或配置代理。

项目创建与运行

创建项目

flutter create my_app
cd my_app

运行项目

连接物理设备或启动模拟器。
执行 flutter run 命令，或通过IDE的运行按钮启动项目。

升级与维护

SDK升级

flutter upgrade

依赖包管理

flutter packages get    # 获取项目依赖
flutter packages upgrade # 升级依赖到最新版本

常见问题解决

flutter doctor 命令卡住：
- 确保网络可以访问国内镜像站点。
- 检查PowerShell版本是否不低于5.0。
模拟器无法识别：
- 对于Android真机，确保已启用USB调试模式。
- 检查模拟器路径配置是否正确。
项目编译失败：

flutter clean      # 清理构建缓存
flutter pub get     # 重新获取依赖包