1. 确保 Flutter 和 VS Code 环境正确配置
安装 Flutter SDK 确保 Flutter 已正确安装,可以在终端运行以下命令检查:
flutter doctor
该命令会显示 Flutter 环境的诊断信息,确保所有项目(包括 Flutter、Dart 插件、设备)都已就绪。
安装 VS Code 插件
搜索并安装 Flutter 和 Dart 插件。
2. 打开新建的 Flutter 项目
在 VS Code 中,使用 File -> Open Folder... 打开新建的 Flutter 项目。
项目结构如下:
my_flutter_app/
├── android/
├── ios/
├── lib/
│ └── main.dart
├── test/
├── pubspec.yaml
└── ...
3. 运行 Flutter 项目
3.1 选择设备
点击 VS Code 界面右下角的 设备选择器(显示为 No Devices 或设备名称)。
如果没有设备显示,你可以:
启动模拟器:
Android 模拟器:
打开 Android Studio。
启动 AVD Manager 并运行一个虚拟设备。
返回 VS Code,模拟器应该会自动显示。
iOS 模拟器(仅 macOS):
open -a Simulator
连接真实设备:
通过 USB 将设备连接到电脑,并确保开启开发者模式。
运行 flutter devices,确认设备已连接。
3.2 启动应用
打开主文件 lib/main.dart。
点击 VS Code 界面右上角的 Run 按钮,或按下快捷键:
macOS: F5 或 Control + F5
Windows/Linux: F5 或 Ctrl + F5
4. 终端命令运行
你也可以直接在 VS Code 的终端中运行以下命令启动项目:
flutter run
5. 热重载和热重启
热重载(Hot Reload): 修改代码后,直接按 r 或点击 VS Code 工具栏上的 热重载按钮(雷电图标)。
优点:无需重新启动应用,大多数代码更改会立即生效。
热重启(Hot Restart): 按 Shift + r 或点击工具栏上的 热重启按钮。
优点:重置应用状态。
6. 常见问题
设备未显示
运行 flutter devices 检查设备是否已被 Flutter 检测到。
如果是 Android 模拟器未显示:
flutter emulators --launch <emulator_id>
运行时报错
依赖问题:
flutter pub get
确保所有依赖已安装。
构建错误: 清理项目并重新构建:
flutter clean
flutter pub get
flutter run