VS Code 需配合 Flutter SDK 和 Dart/Flutter 插件才能开发 Flutter 应用；必须正确配置 flutter 命令的 PATH、ANDROID_HOME 等环境变量，安装官方 Dart 与 Flutter 插件，并通过 flutter create 创建项目验证全流程。
VS Code 本身不自带 Flutter 开发能力，必须通过插件 + 命令行工具链协同工作；直接装插件但没配好 flutter 命令或 ANDROID_HOME，项目能打开却无法运行、调试失败、设备列表为空——这是最常卡住的地方。
安装 Flutter SDK 并确保 flutter 命令全局可用
VS Code 的 Dart/Flutter 插件依赖系统 PATH 中的 flutter 可执行文件。它不帮你装 SDK，也不读取你解压在桌面的 flutter 文件夹路径。
- 从 Flutter 官网下载对应系统的 SDK zip 包（不是 exe/msi 安装器），解压到无中文、无空格路径，例如
C:\src\flutter（Windows）或~/development/flutter（macOS/Linux） - 把
flutter/bin加入系统 PATH：Windows 在「环境变量」中编辑 Path，macOS/Linux 在~/.zshrc或~/.bash_profile中追加export PATH="$PATH:/path/to/flutter/bin" - 终端中执行
flutter --version和flutter doctor -v，确认输出正常；若提示command not found，说明 PATH 没生效，重启 VS Code 或整个终端
安装 Dart 和 Flutter 插件（仅这两个必要）
VS Code 扩展市场里名字带 “Flutter” 的插件有多个，只装官方维护的那两个，其余如 “Flutter Snippets”“Quick Flutter” 属于锦上添花，非必需。
- 在 VS Code 扩展面板搜索并安装：
Dart（由 Dart Team 发布）和Flutter（由 Flutter Team 发布） - 安装后重启 VS Code；打开一个
.dart文件，状态栏右下角应显示 Dart SDK 版本，比如Dart SDK 3.4.3 - 如果状态栏没反应，或点击调试按钮时报
No debug adapter found for flutter，大概率是flutter命令不可达，回退上一步检查 PATH
配置 Android 开发环境（iOS 需 macOS）
flutter doctor 报红最多的通常是 Android 工具链。VS Code 不参与构建 APK，但它调用 flutter run，而后者依赖 Android SDK、JDK、adb 等命令是否就绪。
- Android Studio 不是必须安装，但推荐用它的一键安装方式获取完整 SDK：安装时勾选
Android SDK Command-line Tools（关键！）和Android SDK Platform-Tools - 设置环境变量：
ANDROID_SDK_ROOT指向 Android SDK 根目录（如C:\Users\XXX\AppData\Local\Android\Sdk），同时确保platform-tools和emulator在 PATH 中 - 运行
flutter doctor --android-licenses接受全部协议；若卡住，尝试先执行sdkmanager --licenses - 连接真机或启动模拟器后，
flutter devices应列出设备；VS Code 调试时左下角设备选择器才能出现可选项
创建并运行第一个项目验证全流程
别急着打开旧项目。用 CLI 创建新项目，能绕过缓存、权限、路径编码等隐藏问题，是最可靠的验证方式。
- 终端执行：
flutter create myapp cd myapp flutter run
确保能在命令行成功运行 - 然后用 VS Code 打开
myapp文件夹（不是单个 .dart 文件），按Ctrl+F5（Windows/Linux）或Cmd+R（macOS）启动调试 - 若弹出 “No device connected”，检查设备是否已授权 USB 调试，或模拟器是否已启动且状态为
running；adb devices必须看到设备 - 首次运行可能耗时较长（编译引擎、下载依赖），耐心等待；后续热重载（
Ctrl+S或R）会快很多
最容易被忽略的是：VS Code 启动时不会自动重载 PATH 变更，改完环境变量必须彻底关闭所有 VS Code 窗口再重新打开；另外 Windows 用户若用 Git Bash 或 PowerShell 启动 VS Code，PATH 可能和系统不一致，建议从开始菜单启动。
