Sublime Text 无法配置出完整的 Flutter 开发环境,仅支持语法高亮、基础跳转和手动格式化;必须安装 nickaivazis 或旧版 mrjones 的 Dart 插件,正确设置 dart_sdk_path 并重启分析服务器,补全依赖 LSP-dart,运行与调试必须通过终端完成。

装哪个 Dart 插件才不报红、不跳空
只装 Dart(作者是 nickaivazis 或旧版 mrjones),不是 Dartlang、SublimeDart,更不是任何带 “Flutter” 字样的插件。后三者要么已停更,要么不支持 null safety 后的语法:required、??=、泛型推导全报红,Ctrl+Click 跳转直接失效。
- 通过
Ctrl+Shift+P→Package Control: Install Package搜索Dart,严格核对作者字段 - 安装完必须重启 Sublime,否则右下角不会显示
Dart - 如果右下角没反应,右键文件 →
Open all with current extension as→Dart手动激活
dart_sdk_path 填错等于白配
这个配置项不是必须填,但一旦填错,会直接导致 Failed to start the Dart analysis server 或 Unable to locate SDK。优先走系统 PATH,而不是硬写路径。
- 终端先跑
which dart和flutter doctor -v,确认输出里有类似/opt/homebrew/Caskroom/flutter/3.19.5/flutter/bin/cache/dart-sdk的路径 - 别单独下载 Dart SDK —— 复用 Flutter 自带的,版本才匹配,
analysis_server.dart.snapshot才找得到 - 填路径时,必须指向
cache/dart-sdk目录,不是flutter根目录,也不是dart-sdk/bin - 填完后必须
Ctrl+Shift+P→Dart: Restart Analysis Server,等状态栏出现Analysis server ready
LSP-dart 是补全唯一可行路径,但别指望它多聪明
原生 Dart 插件的补全在 Dart 2.12+ 后就废了,返回空列表或静默失败。想有点提示,只能上 LSP + LSP-dart。
- 先通过
Package Control安装LSP和LSP-dart - 确保终端能跑
dart --version,否则LSP-dart启动失败,状态栏右下角不会显示LSP-dart - 打开
LSP.sublime-settings,把"command"明确设为/path/to/flutter/bin/cache/dart-sdk/bin/dart,不能依赖PATH - 补全不会自动弹,要手动触发:
Ctrl+Shift+P→LSP: Auto Complete,或保存后等几秒再按Ctrl+Space -
WidgetsBinding.instance、required参数、package:flutter里的Widget补全基本靠猜——这是LSP-dart的固有限制,不是你配错了
Ctrl+B 触发 flutter run?别试了,它会卡死
Sublime 的构建系统本质是单次命令执行,不支持长时进程、TTY 交互和 daemon 管理,所以 flutter run 会阻塞面板、无法热重载、也不能响应 r 命令。
- 所有运行、热重载、调试、设备管理都必须依赖终端执行
flutter或dartCLI - 如果你非要用构建系统跑单文件脚本,可配
dart run,但仅限无依赖的 .dart 文件 - Flutter 项目请直接在终端执行
flutter run,然后按r或R触发热重载 - 想快速打开终端,装
Terminus插件,Ctrl+Shift+P→Terminus: Open Default Shell in Panel
~/.zshrc),即使终端里 which dart 有输出,Sublime 也看不见。这不是插件问题,是环境隔离。最稳的解法是——先在 Preferences → Settings – User 里加 "path",填进你的 dart 和 flutter bin 目录,再重启。


















