Sublime Text配置Flutter开发环境详细流程

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 安装包。举个例子，在 macOS 上，正确路径类似 /opt/homebrew/Caskroom/flutter/3.19.5/flutter/bin/cache/dart-sdk，千万别写成 Flutter 的根目录。
• 路径填好后，必须重启 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。
• 最后，别抱太高期望。它无法像 VS Code 那样智能识别 WidgetsBinding.instance 或自动补全 required 参数——LSP-dart 对 Flutter 特有类的支持相当有限，尤其是在没有正确设置 dart_flutter_sdk_path 的情况下。

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

Sublime Text 内置的构建系统机制比较单一：它执行一条命令，然后等待命令结束。这意味着它无法保持一个交互式进程（如 flutter run）持续运行并监听你的输入。所以，所谓的“热重载”只能靠你手动切回终端按 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 正确读取。通过图形界面（比如在 macOS 上点击图标）启动的 Sublime Text，默认不会加载你在 Shell 中配置的环境变量。硬填 SDK 路径只是权宜之计，更稳妥的做法是优先配置好 Settings – User 里的 path 字段，然后重启编辑器本身，而不是仅仅重载设置。