Sublime Text配置Dart语言开发Flutter应用教程

Sublime Text 不能运行 Flutter 应用，也启动不了 Dart VM——它本质上就是一个编辑器，所有的代码跳转、自动补全和格式化功能，都依赖于你本地已经安装好的 dart 和 flutter 命令能否被正确调用。配置失败的原因，90% 都出在 PATH 环境变量没有生效，或者插件连错了 SDK 路径上。

先来拆解第一个也是最常见的问题：Sublime 启动时找不到 dart 命令。这背后的原理很简单：macOS/Linux 环境下，通过 GUI 启动的 Sublime 并不会读取 ~/.zshrc 中的配置，Windows 图形界面启动时也不完全继承系统环境变量。结果就是，终端里能顺利执行 dart --version，但 Sublime 却始终报错 Unable to locate SDK。解决的关键不在于在插件里硬填路径，而是从系统级 path 配置入手。

你只需要做这几步：首先，在终端执行 which dart，记下输出的完整路径（比如 /opt/homebrew/bin/dart 或 /Users/xxx/flutter/bin/cache/dart-sdk/bin/dart）。接着，打开 Sublime，进入 Preferences → Settings – User，添加一行配置，将你记录的实际 bin 路径填入，多个路径用英文冒号分隔。完成配置后，必须重启 Sublime（仅仅是重载设置是不够的），然后按 Ctrl+Shift+P 调出命令面板，执行 Dart: Restart Analysis Server，观察控制台（Ctrl+`）是否出现 Analysis server ready 的提示——这才是配置成功的信号。

解决了基础路径问题，下一个常见困扰是：装好了 Dart 插件，但 Ctrl+Click 跳转不到定义位置。这个问题的根源通常在于旧版分析服务器（use_legacy_analysis_server）对 Flutter 项目的支持非常差。尤其是在解析 package:flutter/material.dart 这类大型导入时，它极容易崩溃或直接返回空结果。具体表现就是，按 F12 跳到空白文件，输入 Text. 后没有任何补全提示，或者右键点击“Go to Definition”直接报错。

解决办法也很直接：打开 Preferences → Package Settings → Dart → Settings – User，确保配置中包含 "use_legacy_analysis_server": false。同时，建议删掉 "dart_sdk_path" 这一行——要么留空，要么写错，都会导致 Failed to start the Dart analysis server 的错误。保存配置后，再次执行 Ctrl+Shift+P → Dart: Restart Analysis Server，让新的设置生效。

如果你发现补全弹不出来，Hover 提示也没有反应，那问题很可能出在插件选择上。原生 Dart 插件默认使用的是已被弃用的分析服务，对 null safety 之后的语法（比如 required、??=、泛型推导）支持很弱，补全延迟高甚至根本不触发。LSP-dart 才是当前稳定且推荐的方案。

使用 LSP-dart 需要先通过 Package Control 安装 LSP 和 LSP-dart 两个插件。在此之前，必须先确认终端能执行 dart --version，否则 LSP-dart 会启动失败，日志中会显示 Cannot find 'dart'。安装完成后，打开一个 .dart 文件，状态栏右下角应该显示 LSP-dart。如果没有，检查 LSP.sublime-settings 中 "dart" 的 "command" 是否指向了正确的 dart 可执行文件。另外需要注意，LSP-dart 的补全不会实时弹出，需要手动触发：按 Ctrl+Shift+P 输入 LSP: Auto Complete，或者在敲完单词后按 Ctrl+Space。

最后，一个容易让人产生误解的点：想按 Ctrl+B 直接运行 flutter run？别指望有现成的“一键运行”功能。Sublime 本身没有内置 Flutter 构建能力，所谓的“运行”实质上是调用外部命令。要实现这个功能，需要手动配置构建系统，而且它只适用于已经初始化好的项目目录，不能用于单独的 .dart 文件。

配置方法如下：点击菜单栏 Tools → Build System → New Build System…，在打开的文件中填入以下内容（以 macOS/Linux 为例）：

{
  "cmd": ["flutter", "run"],
  "working_dir": "${project_path:${folder}}",
  "selector": "source.dart",
  "variants": [
    {
      "name": "Flutter Run (Release)",
      "cmd": ["flutter", "run", "--release"]
    }
  ]
}

保存为 Flutter.sublime-build，然后在菜单栏 Tools → Build System 中选择 Flutter。这里最关键的一点是：working_dir 必须设置为项目的根目录，也就是包含 pubspec.yaml 的那个文件夹，否则 flutter run 会报错，提示找不到 lib/main.dart。

话说回来，即便所有插件都配置得完美无缺，也别忘了 Sublime Text 的定位：它不管理设备连接、不处理热重载的响应、也不解析 pubspec.yaml 中的依赖。当 flutter run 启动后，你仍然需要切换到终端，手动按 r 来触发热重载——Sublime 只负责发送命令，不负责接收和处理结果。这才是整个协作流程中最需要认清的现实。