从零开始:在 VS Code 中运行 Flutter 项目配置流程
前言:写这篇文章主要是记录flutter环境搭建以及项目的运行,因为我自己是使用的是Windows系统,所以此文只做Windows系统配置,macOS本可以参考官方文档
本文将带你一步步完成 VS Code + Flutter 开发环境的配置,确保你能顺利运行第一个 Flutter 项目并调试在 Android 模拟器上运行。
📆 前置准备
✅ 安装 Flutter SDK
-
访问 Flutter 官网
-
选择对应操作系统 (Windows / macOS / Linux)
-
解压并配置环境变量:
- 设置
FLUTTER_HOME - 将
flutter/bin添加到Path
- 设置
验证安装:
flutter doctor
✅ 安装 Android Studio
Android Studio 用于提供:
- Android SDK
- Android 模拟器 (AVD)
- Gradle 构建环境
打开 Android Studio 后:
- 进入 SDK Manager,确保安装 SDK Platform & Tools
- 进入 AVD Manager 创建模拟器
✅ 配置环境变量 (Windows 为例)
| 变量名 | 路径示例 |
|---|---|
ANDROID_HOME | F:\android\SDK |
Path 中添加 | %ANDROID_HOME%\platform-tools``%ANDROID_HOME%\emulator |
✅ 安装 VS Code 插件
- Flutter
- Dart
- Android iOS Emulator (可选)
🧰 验证配置
flutter doctor
如果所有依赖都是绿色 ✓,表示配置完成。
▶️ 创建并运行 Flutter 项目
1. 创建项目
flutter create flutter_demo
cd flutter_demo
code .
2. 启动模拟器
方法一:命令行
emulator -list-avds
emulator -avd Pixel_7
方法二: Flutter 命令
如果你在 VS Code 中运行 Flutter 或 React Native 项目时遇到提示类似
emulator: command not found or No emulator found / No emulator path说明 VS Code 没有找到 Android Emulator 的路径
在 Windows 上使用 PowerShell 执行 $Env:ANDROID_HOME,如果输出路径则证明emulator 加入系统 PATH
在 VS Code 的 PowerShell 终端中执行 Get-Command emulator,如果输出如下错误:
Get-Command : The term 'emulator' is not recognized...,需要重新配置环境变量
F:\android\SDK\emulator
F:\android\SDK\platform-tools
flutter emulators
flutter emulators --launch Pixel_7
看到下图则识别成功
3. 运行项目
flutter run
如果模拟器已启动,就会在其上运行项目。
🧩 常见问题
❌ VS Code 无法识别模拟器
- 检查 PATH 是否启用
%ANDROID_HOME%\emulator - 确认 AVD 是否存在
- 检查 flutter doctor 是否提示缺少组件
❌ emulator: command not found
- 没有配置 PATH
❌ VS Code 说找不到设备
- 重启 VS Code
- 确保模拟器已启动
- 执行
flutter devices
📌 结言
至此,你已经成功在 VS Code 中配置并运行 Flutter 项目,包括 Android 模拟器调试。
如果你想继续深入学习,可以试试:
- 用真机调试
- 点击热重载 hot reload
- 构建 APK 或发布应用
📋 实用命令
flutter doctor # 检查环境
flutter create my_app # 创建项目
flutter run # 运行项目
flutter emulators # 查看模拟器
flutter emulators --launch xxx # 启动模拟器
flutter devices # 查看连接设备
emulator -avd xxx # 启动 AVD 统命令)
flutter run -d emulator-5554 //运行项目到这个设备
emulator -avd Medium_Tablet -gpu host //强制启动
emulator -avd Medium_Tablet //启动设备