Flutter SDK 安装指南 - 课前软件安装

Flutter 简介

Flutter 是 Google 推出的跨平台 UI 工具包，可以使用 Dart 语言开发 Android、iOS、Web、Linux、macOS 和 Windows 应用。一次开发，多平台部署。

一、系统要求

操作系统	最低要求	推荐配置
Windows	Windows 10 或更高版本，64位	Windows 11，8GB RAM
macOS	macOS 10.14 或更高版本	macOS 12+，8GB RAM
Linux	Ubuntu 18.04 或更高版本	Ubuntu 22.04，8GB RAM

二、下载 Flutter SDK

访问 Flutter 官方下载页面：

https://docs.flutter.cn/get-started/install

版本选择

Stable - 推荐大多数用户使用，稳定版本
Beta - 测试版，包含新功能
Dev - 开发版，最新功能

三、Windows 系统安装

1. 下载 Flutter SDK

从官网下载最新的 Flutter SDK 压缩包（.zip 文件）。建议下载 Stable 版本。

2. 解压文件

将下载的文件解压到指定目录。建议路径：C:\src\flutter

注意：路径不要包含中文或特殊字符。

3. 配置环境变量

将 Flutter SDK 的 bin 目录添加到系统 PATH 环境变量：

右键点击"此电脑" → "属性" → "高级系统设置"
点击"环境变量"
在"系统变量"中找到 Path，点击"编辑"
添加 C:\src\flutter\bin
点击"确定"保存

4. 验证安装

打开命令提示符（CMD）或 PowerShell，输入：

flutter --version

四、macOS 系统安装

方法一：通过 Homebrew 安装（推荐）

如果已安装 Homebrew，打开终端执行：

brew install flutter

方法二：手动下载安装

从官网下载 macOS 版本的 Flutter SDK
解压到指定目录，如 ~/development/flutter
在 ~/.zshrc 或 ~/.bash_profile 中添加路径

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

验证安装

flutter --version

五、配置开发环境

1. 运行 Flutter Doctor

Flutter Doctor 是一个诊断工具，可以检查开发环境配置是否完整：

flutter doctor

2. 安装 Android 开发环境

Flutter 需要 Android SDK 进行 Android 开发。请确保：

已安装 Android Studio
Android SDK 已正确配置
接受 Android SDK 许可协议

flutter doctor --android-licenses

3. 配置 Android SDK 路径

如果 Flutter 无法找到 Android SDK，手动设置：

flutter config --android-sdk /path/to/android/sdk

六、创建第一个 Flutter 项目

1. 创建项目

flutter create my_first_app

2. 运行项目

cd my_first_app
flutter run

七、IDE 配置

1. VS Code 配置

推荐安装 Flutter 和 Dart 扩展：

Flutter 扩展
Dart 扩展

2. Android Studio 配置

Android Studio 自带 Flutter 插件支持。

八、常见问题

1. Flutter 命令找不到

解决：确保 Flutter SDK 的 bin 目录已添加到系统 PATH 环境变量，并重启终端。

2. Android SDK 未检测到

运行 flutter doctor 检查问题，并确保 ANDROID_HOME 环境变量已正确设置。

3. 下载依赖失败

在中国大陆地区，建议使用镜像源：

flutter config --package-mirrors https://pub.flutter-io.cn
flutter pub upgrade

Flutter SDK

Flutter SDK 安装与配置完整指南