前端使用Vscode搭建flutter

3,783 阅读2分钟

从零开始:在 VS Code 中运行 Flutter 项目配置流程

前言:写这篇文章主要是记录flutter环境搭建以及项目的运行,因为我自己是使用的是Windows系统,所以此文只做Windows系统配置,macOS本可以参考官方文档

本文将带你一步步完成 VS Code + Flutter 开发环境的配置,确保你能顺利运行第一个 Flutter 项目并调试在 Android 模拟器上运行。


📆 前置准备

✅ 安装 Flutter SDK

  1. 访问 Flutter 官网

  2. 选择对应操作系统 (Windows / macOS / Linux)

  3. 解压并配置环境变量:

    • 设置 FLUTTER_HOME
    • flutter/bin 添加到 Path

验证安装:

flutter doctor

✅ 安装 Android Studio

Android Studio 用于提供:

  • Android SDK
  • Android 模拟器 (AVD)
  • Gradle 构建环境

打开 Android Studio 后:

  1. 进入 SDK Manager,确保安装 SDK Platform & Tools
  2. 进入 AVD Manager 创建模拟器

✅ 配置环境变量 (Windows 为例)

变量名路径示例
ANDROID_HOMEF:\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

看到下图则识别成功 image.png


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 //启动设备