dart 语法错误由 dart 分析器实时标出，需确保其正常运行：先验证 pubspec.yaml 合法性，执行 flutter pub get，等待“analysis server ready”提示；调试需 launch.json 中 request 为 "launch"、type 为 "dart"、cwd 为项目根目录；仅安装官方 dart code 和 flutter 插件，并彻底重启 vs code。
VSCode 里 Dart 语法错误靠 Dart 分析器（Analysis Server）实时标出，不是靠 ESLint 或其他第三方 Linter；它直接读 pubspec.yaml 和 SDK 类型系统，标红位置准、提示快，但前提是分析器必须“活”着。
为什么写 Text( 没补全、也不报错？
这不是插件坏了，是 Dart 分析器还没加载完项目上下文。常见于新建 flutter create 项目后立刻打开——此时 pubspec.yaml 已存在，但依赖没拉、分析器没初始化。
- 确认项目根目录有合法的
pubspec.yaml（name:后不能是中文、空格或特殊字符） - 在 VS Code 内置终端中手动运行
flutter pub get（别点右上角 GUI 按钮，它常静默失败） - 等右下角状态栏出现
Analysis server ready，此时波浪线、悬停文档、Ctrl+Click 跳转才真正生效 - 如果卡住超 2 分钟，按
Ctrl+Shift+P输入Dart: Restart Analysis Server强制刷新
launch.json 配错导致断点不命中
F5 启动后控制台只输出 Launching lib/main.dart on Chrome... 就结束，断点完全不触发——说明调试会话没进“调试模式”，而是退化成了热重载启动。
- 确保
.vscode/launch.json中request字段值为"launch"，不是"attach"或空 -
type必须是"dart"，不是"flutter"或"chrome" - 首次 F5 若提示创建配置，选
Dart & Flutter模板即可；别手动改program路径指向bin/main.dart（Flutter 项目入口固定是lib/main.dart） - 检查
cwd是否为项目根目录（即含pubspec.yaml的那一层），否则分析器找不到包依赖
插件装多反而报 Cannot resolve a concrete Dart SDK
VS Code 扩展市场搜 “Dart” 会出来一堆名字近似的插件，但只有两个是官方维护且相互兼容的：一个负责语言服务，一个负责 Flutter 工具链集成。
- 卸载所有 Dart/Flutter 相关插件（包括 “Dart Support”、“Flutter Snippets”、“Quick Flutter”）
- 仅安装
Dart Code（发布者：Dart-Code.dart-code） - 再安装
Flutter（发布者：Flutter Team，它会自动启用Dart Code） - 装完必须彻底退出 VS Code（不是关窗口），再重开；打开任意
.dart文件，右下角应显示类似Dart SDK 3.6.x和Flutter SDK: /path/to/flutter
最容易被忽略的是：分析器是否真在工作——它不依赖 flutter doctor -v 的 ✅，只认 Analysis server ready 这个状态。没看到这行字，补全、跳转、断点、甚至波浪线语法检查，都不可信。
