sublime text无法配置出真正可用的flutter开发环境,仅支持语法高亮、基础跳转和手动格式化;不支持热重载、调试、设备管理及dart 3.4+/flutter 3.22+语言服务器。

Sublime Text 不能配置出可用的 Flutter 开发环境,它连不上 Dart 3.4+/Flutter 3.22+ 的语言服务器,也不支持热重载、设备管理或调试;你最多能配出语法高亮、基础跳转和手动格式化——前提是 PATH 正确、插件选对、分析服务器重启到位。
装 Dart 插件必须认准作者,别被名字骗
只装 Dart(作者是 nickaivazis 或旧版 mrjones),不是 Dartlang、SublimeDart,更不是任何带 “Flutter” 字样的插件。后三者要么已停更,要么不支持 null safety 后的语法,required、??=、泛型推导全报红,跳转直接失效。
安装路径: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。
安装后关键动作:
- 确保终端能跑
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 对 Flutter 特有类支持很弱
Ctrl+B 运行 flutter run?别试了,它卡死是设计如此
Sublime 的构建系统不继承完整 shell 环境,缺失 FLUTTER_ROOT 和 PATH 中的 flutter/bin,也不支持长时进程、TTY 交互和 daemon 管理。你点 Ctrl+B,它最多执行一条命令就停住,根本等不到设备连接或热重载。
常见错误包括:
-
Command "run" not found(找不到 flutter 命令) -
No devices detected(设备检测失败,和 Sublime 无关) - 进程挂起无响应(因为 flutter run 需要持续 stdin/stdout 通信)
真要运行,就老老实实切终端:cd my_app → flutter run → 按 r 触发热重载。Sublime 只负责写代码,别让它干 IDE 的活。











