Sublime Text 无法配置真正可用的 Flutter 开发环境，仅支持语法高亮、基础跳转和手动构建

先说结论：Sublime Text 无法搭建功能齐全的 Flutter 开发环境。

它本质上不支持热重载、设备管理、调试器集成，也无法兼容 Dart 3.4+ 和 Flutter 3.22+ 的语言服务器协议。

即使折腾完成，你最多也只能得到一个具备语法高亮、基础跳转和手动构建功能的 Dart 代码编辑器。仅此而已。

为什么 Dart 插件里 Ctrl+Click 跳不到定义

跳转失效，通常不是插件没装好。

更常见的原因是底层分析服务器没有启动，或者 dart_sdk_path 这个关键路径配置错误。

• dart_sdk_path 必须指向 Flutter 自带的 Dart SDK。 不能指向独立的 Dart 安装包，也不能直接写成 Flutter 根目录。
• 例如在 macOS 上，正确路径类似 /opt/homebrew/Caskroom/flutter/3.19.5/flutter/bin/cache/dart-sdk。
• 路径填写完成后，需要重启 Sublime Text，或者按 Ctrl+Shift+P 执行 Dart: Restart Analysis Server。

如果仍然无法跳转，可以继续排查：

• 打开控制台，快捷键是 Ctrl+`。
• 如果出现 Failed to start the Dart analysis server 或 Unable to locate SDK，基本可以判断是路径错误，或者系统找不到 dart 命令。
• 还有一个常见问题：终端里执行 which dart 明明有输出，但 Sublime 里没有反应。
• 这通常说明 Sublime 没有继承终端的 PATH 环境变量。

这种情况下，可以在 Preferences → Settings – User 中手动添加配置：

"path": "/opt/homebrew/bin:/usr/local/bin"

具体路径请根据你的实际环境调整。

LSP-dart 补全为啥不弹出、不识别 Widget

原生 Dart 插件的代码补全功能早已停摆。

自 Dart 2.12+ 版本彻底废弃旧的分析协议后，它要么返回空列表，要么直接报错。

如果想获得有限的智能提示，唯一可行的方向就是使用 LSP（Language Server Protocol）。

• 先通过 Package Control 安装 LSP 和 LSP-dart。
• 安装完成后，确认终端里可以正常执行 dart --version。
• LSP-dart 启动时会主动查找 dart 命令。找不到时，它会静默失败，状态栏右下角也不会显示 LSP-dart 已激活。

接着检查 LSP.sublime-settings：

• 确认其中的 "command" 字段指向 Flutter 内置的 Dart SDK 路径。
• 例如应指向 flutter/bin/cache/dart-sdk/bin/dart。
• 不要误用系统 PATH 里的其他 dart，否则很容易出现版本不匹配。

另外还要注意，补全通常不会自动弹出：

• 可以按 Ctrl+Shift+P，输入 LSP: Auto Complete 手动触发。
• 也可以在保存文件几秒后，再按 Ctrl+Space。

不过不要抱太高期望。

LSP-dart 无法像 VS Code 那样智能识别 WidgetsBinding.instance，也不能稳定自动补全 required 参数。

它对 Flutter 特有类的支持本来就有限，尤其是在没有正确设置 dart_flutter_sdk_path 的情况下。

怎么让 Ctrl+B 触发 flutter run 却不卡死

Sublime Text 内置的构建系统机制比较单一。

它只会执行一条命令，然后等待命令结束。

这意味着它无法持续维护像 flutter run 这样的交互式进程，也无法持续监听你的输入。

所以，所谓“热重载”并不能在 Sublime Text 内真正完成。

应用跑起来后，你仍然需要手动切回终端，按 r 实现热重载。

• 先点击 Tools → Build System → New Build System。
• 然后填入下面这份配置。
• 其中 working_dir 必须设置为项目根目录，否则 flutter run 会找不到 pubspec.yaml。

{
  "cmd": ["flutter", "run"],
  "selector": "source.dart",
  "working_dir": "$project_path",
  "variants": [
    {
      "name": "Run on Device",
      "cmd": ["flutter", "run"]
    },
    {
      "name": "Build APK",
      "cmd": ["flutter", "build", "apk", "--release"]
    }
  ]
}

• 将文件保存为 Flutter.sublime-build。
• 保存后，在 Tools → Build System 菜单中选中它。
• 之后按下 Ctrl+B，Sublime Text 会在新面板中执行 flutter run。
• 但应用启动完成后，你还是必须切换到终端窗口，手动按 r 进行热重载，或按 R 进行热重启。

还有一点要特别注意：

• 不要尝试在构建配置里加入 "shell": true。
• 也不要指望通过后台运行参数解决问题。
• Sublime Text 本身就不支持管理交互式长进程的标准输入输出。

最后这个前提最容易被忽略

上面提到的所有功能，都依赖同一个前提：你本地的 dart 和 flutter 命令必须能被 Sublime Text 正确读取。

如果你是通过图形界面启动 Sublime Text，例如在 macOS 上直接点击图标，默认情况下它不会加载你在 Shell 中配置的环境变量。

硬填 SDK 路径只能算权宜之计。

更稳妥的做法是，优先配置好 Settings – User 里的 path 字段，然后重启编辑器本身，而不是只重载设置。