Sublime Text 无法配置出真正可用的 Flutter 开发环境,仅能作为带语法高亮和基础跳转的 Dart 编辑器;热重载、调试、设备管理及现代 Dart/Flutter 语言服务器均不支持。

Sublime Text 不能真正配置出“可用的”Flutter 开发环境——它不支持热重载、设备管理、调试器集成,也不兼容 Dart 3.4+ 和 Flutter 3.22+ 的语言服务器协议。你最多能把它调成一个带语法高亮、基础跳转和手动构建触发的 Dart 代码编辑器。
装 Dart 插件但 Ctrl+Click 跳不到源码?检查 dart_sdk_path 和分析服务器状态
跳转失效不是插件没装好,而是分析服务器(analysis server)根本没起来,或者路径指向了错误位置。
-
dart_sdk_path必须填 Flutter 自带的 SDK 路径,比如 macOS 上是/opt/homebrew/Caskroom/flutter/3.19.5/flutter/bin/cache/dart-sdk,不是/opt/homebrew/Caskroom/flutter/3.19.5/flutter,更不是单独安装的 Dart SDK - 填完后必须重启 Sublime,或手动执行
Ctrl+Shift+P→Dart: Restart Analysis Server - 打开控制台(
Ctrl+`),看有没有Failed to start the Dart analysis server或Unable to locate SDK—— 这两类错误基本都源于路径错或dart命令不可达 - 如果终端里
which dart有输出,但 Sublime 里没反应,大概率是 PATH 没传进去:在Preferences → Settings – User里加"path": "/opt/homebrew/bin:/usr/local/bin"(按你实际的 bin 目录改)
Ctrl+Space 没补全?LSP-dart 是唯一可行路径,但依赖 dart 命令可用
原生 Dart 插件的补全早就不工作了,Dart 2.12+ 彻底废弃旧分析协议,它只返回空列表或直接报错。想有点智能提示,只能上 LSP。
- 先通过 Package Control 安装
LSP和LSP-dart - 确保终端能跑
dart --version;LSP-dart 启动时会找dart,找不到就静默失败,状态栏右下角不会显示LSP-dart - 在
LSP.sublime-settings里确认"command"指向的是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时
想用 flutter run?只能靠自定义 Build System,且无法热重载
Sublime 内置构建系统只能发一条命令、等它结束,没法保持进程运行并监听输入。所谓“热重载”只能靠你切回终端按 r。
- 新建 Build System(
Tools → Build System → New Build System…),内容填:
{
"cmd": ["flutter", "run"],
"selector": "source.dart",
"working_dir": "$project_path",
"variants": [
{
"name": "Run on Device",
"cmd": ["flutter", "run"]
}
]
}
- 保存为
Flutter.sublime-build,然后在项目根目录用Project → Open Project加载.sublime-project文件(否则$project_path为空) - 这个构建系统只是帮你省掉一次敲命令,
flutter run启动后 Sublime 就不管了——它不会捕获 stdout、不转发键盘输入、不重载页面 - 真要边写边看效果,得开个独立终端跑
flutter run,改完保存,切过去按r;或者装Terminus插件把终端嵌进 Sublime,再配 key binding 把r绑到 Terminus 面板,但容易卡死
最常被忽略的一点:所有配置都建立在系统级 flutter 和 dart 命令可用的前提下。如果 flutter doctor 过不去,Sublime 里做再多设置也只是在修表面。另外,2026 年起几乎所有社区维护的 Flutter/Sublime 插件都已停更,别在 Package Control 里搜 “Flutter”——搜到的全是 2020 年前的老包,装了反而干扰分析服务器启动。











