
需依次安装Dart SDK、Flutter SDK、VS Code的Dart与Flutter扩展,并配置模拟器或真机,最后通过flutter create创建项目验证环境。
如果您希望在本地计算机上开始使用 Dart 和 Flutter 进行移动应用开发,但尚未配置 VS Code 的相关开发环境,则可能是由于缺少必要扩展、SDK 未正确安装或路径未纳入系统变量。以下是完成该环境搭建的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
Dart SDK 是运行和编译 Dart 代码的基础运行时环境,Flutter SDK 已内置 Dart,但独立安装可确保命令行工具 dart 全局可用,并支持非 Flutter 的纯 Dart 项目。
1、访问 https://dart.dev/get-dart,下载对应 macOS 的 Dart SDK ZIP 包。
2、解压 ZIP 文件至 /usr/local/share/dart-sdk 目录。
3、将 /usr/local/share/dart-sdk/bin 添加到系统 PATH:编辑 ~/.zshrc,追加 export PATH="/usr/local/share/dart-sdk/bin:$PATH"。
4、执行 source ~/.zshrc 并运行 dart --version 验证安装成功。
Flutter SDK 提供了完整的框架、工具链与预编译引擎,是构建跨平台移动应用的核心依赖,其自带的 dart 命令与 flutter 命令需协同工作。
1、前往 https://flutter.dev/docs/get-started/install/macos 下载最新稳定版 Flutter SDK ZIP。
2、解压至用户主目录下的 ~/development/flutter 路径。
3、在 ~/.zshrc 中添加 export PATH="$PATH:$HOME/development/flutter/bin"。
4、重新加载配置并运行 flutter doctor,检查是否提示缺失 Android Studio 或 Xcode 工具链。
VS Code 本身不原生支持 Dart/Flutter 语法高亮、调试与热重载功能,必须通过官方扩展启用语言服务与集成调试器。
1、启动 VS Code,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。
2、在搜索框中输入 Dart Code,选择由 Dart Code 团队发布的扩展并点击安装。
3、安装完成后,再次搜索 Flutter,安装同团队发布的 Flutter 扩展(该扩展会自动启用 Dart 扩展依赖)。
4、重启 VS Code,打开任意 .dart 文件,确认右下角状态栏显示 Dart 语言模式且无红色波浪线警告。
运行 Flutter 应用需目标设备支撑,iOS 开发依赖 Xcode 自带模拟器,Android 开发依赖 Android Studio 的 AVD 或已开启 USB 调试的物理设备。
1、对于 iOS:打开 Xcode → Preferences → Components,下载最新 Simulator 运行时(如 iOS 17.5)。
2、对于 Android:启动 Android Studio → SDK Manager → 安装 Android SDK Platform-Tools 与至少一个 System Image(如 ARM64 v8a)。
3、在终端运行 flutter devices,确认输出中包含 iPhone 15 Pro 或 sdk gphone64 arm64 等可用设备标识。
4、若连接真机,需在手机开发者选项中启用 USB debugging,并在 Mac 上信任该设备。
验证整个工具链是否连通的关键操作,项目初始化过程将触发依赖拉取、插件生成及平台模板构建。
1、在终端中执行 flutter create my_first_app,等待命令完成并显示 All done!。
2、进入项目目录:cd my_first_app。
3、在 VS Code 中通过 File → Open Folder 打开该项目文件夹。
4、按下 Cmd+P,输入 >Flutter: Run Flutter App,选择目标设备后启动调试会话
。