若VSCode无法识别Flutter SDK或调试失败，需依次完成：一、下载SDK并配置~/.zshrc路径；二、安装Dart与Flutter扩展；三、通过命令面板手动指定SDK路径；四、新建项目并连接设备验证；五、修复launch.json、清理进程与缓存。
如果您希望在本地搭建一个用于开发Flutter和Dart移动应用的集成开发环境，但VSCode未能正确识别Flutter SDK或无法运行调试会话，则可能是由于扩展未安装、路径配置错误或SDK未正确初始化所致。以下是完成该环境配置的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装Flutter SDK并配置系统路径
此步骤确保命令行和VSCode均可全局访问flutter命令，是后续所有功能正常运行的基础。
1、访问 https://flutter.dev/docs/get-started/install 下载对应 macOS 平台的最新稳定版 Flutter SDK 压缩包。
2、解压下载文件至用户主目录下的 /Users/用户名/flutter 路径（避免空格与中文路径）。
3、打开终端，执行 nano ~/.zshrc，在文件末尾添加以下两行：
export PATH=$PATH:/Users/用户名/flutter/bin
export PUB_HOSTED_URL=https://pub.flutter-io.cn
4、保存后执行 source ~/.zshrc 使配置生效。
5、运行 flutter doctor -v 验证安装结果，确认无红色叉号报错。
二、在VSCode中安装必要扩展
VSCode本身不具备Dart/Flutter开发能力，需通过官方扩展提供语法支持、调试器、热重载及项目模板等功能。
1、启动VSCode，在左侧活动栏点击扩展图标（方块拼图形状）。
2、在搜索框中输入 Dart Code，找到由 Dart-Code 团队发布的扩展并点击安装。
3、再次搜索 Flutter，安装同团队发布的 Flutter 扩展（该扩展会自动依赖并启用 Dart 扩展）。
4、安装完成后重启VSCode，确保扩展已激活。
三、配置VSCode中的Flutter SDK路径
当 flutter doctor 显示正常但VSCode仍提示“Flutter SDK not found”时，需手动指定SDK位置。
RhaPHP 是一款免费开源的微信公众号管理营销系统！也是一款微信公众号开发框架。简洁，灵活，快速易开发，应用模块化，支持移动端管理微信公众号。基于 THINKPHP5，简单的代码即可实现微信公众号通信与接口实现。不需要花大量时间研究系统即可快速开发微信应用，rhaphp在微信开发有着灵活机制，支持移动管理微信公众号。系统运行环境 PHP+MYSQL。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Flutter: Change SDK Path。
3、在弹出的路径选择框中，定位到 /Users/用户名/flutter 目录并确认。
4、等待VSCode右下角出现 Dart SDK loaded 提示，表示配置成功。
四、创建并验证首个Flutter项目
通过新建项目可检验整个工具链是否协同工作，包括设备检测、构建流程与调试器连接。
1、在VSCode中按下 Cmd + Shift + P，输入并选择 Flutter: New Project。
2、输入项目名称（如 my_first_app），回车确认，默认保存至用户文档目录。
3、等待项目初始化完成，VSCode将自动打开该项目文件夹。
4、连接iOS模拟器或Android设备（确保 flutter devices 可识别目标设备）。
5、按 F5 启动调试，选择设备后观察控制台输出，确认App成功部署并运行。
五、修复常见调试失败问题
当F5启动失败或断点不触发时，可能因工作区配置缺失、端口冲突或插件缓存异常导致，需针对性处理。
1、在项目根目录下检查是否存在 .vscode/launch.json 文件；若不存在，执行 Debug: Open launch.json 并选择 Dart & Flutter 自动生成。
2、关闭所有正在运行的 dart.exe 或 flutter_tools.dart.snapshot 进程（macOS可在活动监视器中搜索“dart”强制退出）。
3、在VSCode中依次点击 File → Preferences → Settings，搜索 dart.debugExternalPackageLibraries，将其设为 true 以启用外部包断点支持。
4、删除项目目录下的 .dart_tool 和 build 文件夹，然后执行 flutter clean && flutter pub get 重建依赖。
