需先安装Flutter与Dart SDK并配置PATH，再安装VSCode官方Dart插件，打开Flutter项目后验证状态栏提示，配置launch.json启用调试，最后确保Dart分析器正常工作以提供实时错误提示。
如果您在Visual Studio Code中进行Flutter开发，但Dart插件未正确配置或功能异常，则可能导致代码补全、调试支持、语法高亮等核心开发体验缺失。以下是完成VSCode Dart插件基础配置与验证的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装Dart与Flutter SDK
VSCode的Dart插件依赖本地已安装的Dart SDK和Flutter SDK，二者需预先下载并加入系统PATH。插件本身不附带运行时，仅提供编辑器集成能力。
1、访问https://flutter.dev/docs/get-started/install，下载对应macOS平台的Flutter SDK压缩包。
2、解压至用户主目录下的/Users/用户名/flutter路径。
3、在终端中执行export PATH="$PATH:/Users/用户名/flutter/bin"，并将其写入shell配置文件（如~/.zshrc）以持久生效。
4、运行flutter doctor验证SDK完整性及依赖项状态。
二、安装VSCode Dart扩展
Dart插件是VSCode中启用Dart语言服务与Flutter工具链集成的前提，必须通过官方扩展市场安装由Dart-Code团队发布的权威版本。
1、打开VSCode，点击左侧活动栏的扩展图标（或按Cmd+Shift+X）。
2、在搜索框中输入Dart Code，确认发布者为Dart-Code且名称为Dart（图标为蓝色D字母）。
3、点击“安装”按钮，安装完成后重启VSCode。
三、启用Flutter支持并验证项目识别
当Dart插件检测到工作区根目录下存在pubspec.yaml且包含flutter依赖时，会自动激活Flutter模式，启用设备选择、热重载按钮及widget预览等特性。
1、在VSCode中打开一个已存在的Flutter项目文件夹（确保包含pubspec.yaml和lib/main.dart）。
2、等待右下角状态栏出现Dart: Ready提示，且显示当前Flutter SDK路径。
3、按下Cmd+Shift+P，输入Flutter: New Project可创建新项目；输入Flutter: Select Device可查看已连接设备列表。
四、配置launch.json启动调试
VSCode需通过launch.json定义调试入口，才能启动Flutter应用并支持断点、变量监视等调试功能。该配置文件位于.vscode/目录下，由插件自动生成或手动创建。
1、打开命令面板（Cmd+Shift+P），输入并选择Dart: Open Launch Configuration。
2、若提示生成默认配置，选择Flutter模板，插件将创建包含"type": "dart"和"request": "launch"的JSON对象。
3、确认配置中"program"字段指向lib/main.dart，且"flutterMode"值为"debug"。
五、启用分析器与实时错误提示
Dart分析器是插件内置的语言服务器，负责静态分析、错误标记与快速修复建议。其运行状态直接影响代码编辑时的即时反馈质量。
1、在VSCode设置中搜索dart.analyzerPath，留空表示使用SDK内嵌分析器；若指定路径，须指向Flutter SDK中bin/cache/dart-sdk/bin/dartanalyzer。
2、打开任意.dart文件，观察编辑器是否在语法错误行左侧显示红色波浪线，并悬停显示错误详情。
3、在设置中启用dart.showTodos，使注释中的TODO、FIXME等标记以黄色高亮呈现于侧边栏。
