Sublime Text中Dart插件失效主因是PATH未生效、dart_sdk_path配置错误、格式化双开关未全开或启用旧版分析服务器；应优先配置系统PATH，复用Flutter内置Dart SDK，开启dart_format_on_save和format_on_save，并设use_legacy_analysis_server为false。
装 Dart 插件但没反应？检查 Dart 和 Flutter 的 PATH 是否生效
Sublime Text 本身不运行 Dart，它靠外部命令（比如 dart、flutter）提供语法检查、补全和格式化。插件装了却没提示、按 Ctrl+Shift+P 找不到 Dart: Format File，大概率是终端能跑的命令，Sublime 看不见。
- 在终端执行
which dart和which flutter，确认路径存在（如/opt/homebrew/bin/dart） - Sublime 默认不读 shell 的
~/.zshrc或~/.bash_profile，得手动告诉它路径：打开Preferences → Settings – User，加这一行："path": "/opt/homebrew/bin:/usr/local/bin"
（把你的实际 bin 路径填进去） - 重启 Sublime，再试
Ctrl+Shift+P → Dart: Restart Analysis Server，如果报错消失，说明 PATH 活了
Dart 插件配置里 dart_sdk_path 到底填什么？
这个配置只在你没走系统 PATH、或 SDK 装在非标准位置时才需要。Flutter 自带 Dart SDK，别单独下载另一个；直接复用 Flutter 里的更省心、版本也匹配。
- 查 Flutter 内置 Dart 路径：
flutter doctor -v会打印类似Dart SDK at: /path/to/flutter/bin/cache/dart-sdk - 在 Sublime 的
Preferences → Package Settings → Dart → Settings – User里写："dart_sdk_path": "/path/to/flutter/bin/cache/dart-sdk"
- 填错会导致分析器启动失败，错误信息通常是
Failed to start the Dart analysis server—— 此时删掉这行，改用上面的 PATH 方案更稳
保存自动格式化失效？确认 dart_format_on_save 和 format_on_save 都开了
Sublime 的格式化依赖两层开关：插件级控制 + 编辑器级触发。只开一个，保存时不会调 dart format。
- 在 Dart 插件设置里确保：
"dart_format_on_save": true
- 同时在 Sublime 全局设置（
Preferences → Settings）里也要有："format_on_save": true
- 如果项目用的是
analysis_options.yaml自定义规则，格式化结果可能和 VS Code 不同——这是预期行为，不是 bug - 格式化卡住？可能是分析服务器没起来，先执行
Dart: Restart Analysis Server
跳转定义/查找引用不准？关掉 use_legacy_analysis_server
旧版分析服务器（legacy）对 Flutter 项目支持弱，尤其涉及 lib/main.dart 引用 package:flutter 时容易失灵，表现为右键 Go to Definition 跳到空文件或报错。
- 在 Dart 插件用户设置里加：
"use_legacy_analysis_server": false
- 这个选项默认为
false，但某些老版本插件或手动改过配置的机器可能开着它 - 关掉后首次启动分析服务器会稍慢（加载 SDK 和依赖），之后跳转、补全响应明显更准
- 如果仍不准，检查项目根目录是否有
.packages或.dart_tool/package_config.json—— 没这两个，插件压根不知道你用了哪些包
