环境准备：Flutter SDK安装、Android Studio配置、创建第一个Flutter项目

说实话，很多初学者在环境搭建这一步就卡住了。我见过不少同学，下载了SDK却配不好路径，装好了Android Studio又发现连不上模拟器。嗯，今天咱们就把这些坑一个个填平。

Flutter SDK安装

先说说Flutter SDK。这东西说白了就是Flutter的"引擎"，没有它你啥也干不了。

下载SDK

去Flutter官网下载对应你操作系统的SDK包。我个人习惯用稳定版（stable channel），毕竟做项目求稳嘛。

• Windows用户：下载zip包，解压到 C:\src\flutter（我建议别放中文路径，否则后面有你哭的）
• macOS用户：下载zip包，解压到 ~/development/flutter
• Linux用户：同样解压到 ~/development/flutter

配置环境变量

这一步很关键。你需要把Flutter的bin目录加到系统的PATH里。

Windows：

# 打开系统环境变量设置
# 在"用户变量"或"系统变量"中找到Path，添加：
C:\src\flutter\bin

# 新建一个变量：
变量名：FLUTTER_HOME
变量值：C:\src\flutter

macOS / Linux：

# 编辑 ~/.bashrc 或 ~/.zshrc
export FLUTTER_HOME=~/development/flutter
export PATH=$PATH:$FLUTTER_HOME/bin

# 然后执行
source ~/.bashrc  # 或 source ~/.zshrc

验证安装

打开终端或命令行，输入：

flutter --version

如果能看到版本号，恭喜你，第一步走通了。如果提示"flutter不是内部命令"，别慌——八成是环境变量没配好，回去检查一下路径。

Android Studio配置

Flutter开发离不开Android Studio。为什么？因为它集成了Flutter插件、Dart插件、模拟器管理，一套搞定。

安装Android Studio

去官网下载最新版。我个人建议用稳定版，别追新。我记得有一次手贱装了预览版，结果插件不兼容，回滚花了大半天。

安装Flutter和Dart插件

1. 打开Android Studio，进入 File → Settings → Plugins
2. 搜索"Flutter"，点击安装
3. 它会提示你同时安装Dart插件，同意就行
4. 重启Android Studio

配置Android SDK

Android Studio自带SDK管理器。你需要确保安装了以下组件：

组件	说明	版本建议
Android SDK Platform	编译目标平台	至少API 33+
Android SDK Build-Tools	构建工具	最新稳定版
Android SDK Command-line Tools	命令行工具	最新版
Android Emulator	模拟器	最新版

配置路径：File → Settings → Appearance & Behavior → System Settings → Android SDK

配置模拟器

点击工具栏的"Device Manager"，新建一个虚拟设备。我建议选Pixel 6或Nexus 6P的镜像，兼容性好。系统镜像选API 33或34，别选太老的版本——你想想看，新项目总得面向新系统吧？

创建第一个Flutter项目

环境都配好了，咱们来跑一个Hello World。

方式一：命令行创建

flutter create my_first_app
cd my_first_app
flutter run

就这么简单。它会自动生成一个计数器应用，点击按钮数字会加1。我第一次跑起来的时候，说实话还挺激动的——虽然只是个计数器，但那是自己亲手搭的环境跑出来的。

方式二：Android Studio创建

1. 点击 File → New → New Flutter Project
2. 选择 Flutter Application
3. 填写项目名（小写+下划线，比如 my_first_app）
4. 选择SDK路径（如果自动识别了就不用管）
5. 点击Finish

等它同步完依赖，点击绿色的运行按钮，选择模拟器，就能看到效果了。

项目结构速览

创建完成后，你会看到这样的目录结构：

my_first_app/
├── android/          # Android原生代码
├── ios/              # iOS原生代码
├── lib/              # Dart代码（主要在这里写）
│   └── main.dart     # 入口文件
├── test/             # 测试代码
├── pubspec.yaml      # 依赖配置文件
└── README.md         # 项目说明

你想想看，一个Flutter项目其实就是一个壳，里面包着Android和iOS的原生代码。我们写的Dart代码在lib目录下，最终会被编译成原生代码运行。

核心知识体系

我把本章的知识点整理成了一张图，方便你理解整个流程：

避坑指南

最后分享几个我踩过的坑：

• flutter doctor 报错：运行 flutter doctor 可以检查环境问题。如果提示"Android license not accepted"，运行 flutter doctor --android-licenses 同意协议就行。
• 模拟器启动慢：我建议用真机调试，USB连上就能跑，比模拟器快多了。记得打开开发者选项和USB调试。
• 网络问题：如果创建项目时下载依赖失败，可以配置国内镜像。在环境变量里加 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL，指向国内镜像站。

环境准备这块，说白了就是一次配置，长期受益。我第一次配环境花了整整一个下午，各种报错、各种查资料。但配好之后，后面写代码就顺畅多了。嗯，耐心点，你也能搞定。

---

公众号:蓝海资料掘金营，微信deep3321