需安装Dart Frog扩展、配置Dart SDK路径、初始化项目并启用调试、修复路由热重载失效问题。具体包括：安装官方扩展并重启；设置dart.sdkPath为which dart输出路径；用dart_frog create创建项目后通过命令启动调试；检查排除规则、禁用实验性文件监听器并重载窗口。

如果您正在使用 Visual Studio Code 进行 Dart Frog 框架的后端开发，则可能遇到项目无法启动、调试器连接失败或代码补全不生效等问题。以下是针对这些常见场景的多种解决方法：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装并启用 Dart Frog 扩展

VSCode 需通过官方扩展支持 Dart Frog 的 CLI 集成与模板生成，缺失该扩展将导致命令不可用、项目初始化失败或路由热重载异常。

1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。

2、在搜索框中输入 Dart Frog，找到由 Dart Frog 官方发布的扩展（作者显示为 “Dart Frog Team”）。

3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。

二、配置 Dart SDK 路径

Dart Frog 依赖本地 Dart SDK 运行时环境，若 VSCode 未正确识别 Dart 可执行路径，则无法执行 dart_frog dev 或生成新路由。

1、在终端中运行 which dart，复制输出的完整路径（例如 /opt/homebrew/bin/dart）。

2、在 VSCode 中按下 Cmd+, 打开设置，搜索 dart.sdkPath。

3、点击“编辑 in settings.json”，在 JSON 中添加键值对："dart.sdkPath": "/opt/homebrew/bin/dart"（路径需与上一步一致）。

三、初始化 Dart Frog 项目并启用调试

新建项目时若跳过 CLI 初始化步骤，会导致缺少 .vscode/launch.json 配置，进而无法启动调试会话。

1、在终端中进入目标目录，运行 dart_frog create my_api 创建标准项目结构。

2、在 VSCode 中打开该项目文件夹（非仅打开单个文件）。

3、按 Cmd+Shift+P，输入 Dart Frog: Start Debugging，选择默认配置并确认。

四、修复路由热重载失效问题

Dart Frog 的热重载依赖文件系统监听机制，若 VSCode 在非标准工作区打开项目或启用了排除规则，可能导致修改路由后服务未自动更新。

1、检查项目根目录下是否存在 .vscode/settings.json，确认其中无 "files.watcherExclude" 对 routes/** 的误匹配。

2、在 VSCode 设置中搜索 files.useExperimentalFileWatcher，将其设为 false。

3、重启 VSCode 窗口（Cmd+Shift+P → Developer: Reload Window）。