Sublime Text 不能运行 Dart 或 Flutter,仅支持语法高亮、跳转、格式化等基础编辑功能;需手动配置 Dart 插件(作者 Dart-Code 团队)和 Flutter 自带的 dart-sdk 路径,并重启分析服务器才能启用补全与错误提示。

Sublime Text 不能运行 Dart 或 Flutter,只负责写代码;高亮、跳转、格式化这些基础功能能配出来,但必须手动连上你本地已装好的 Dart SDK(推荐直接复用 Flutter 自带的),否则插件就是摆设。
装哪个 Dart 插件才有效
装 Dart(作者是 Dart-Code 团队),不是 Dartlang、SublimeDart 或名字带 “Flutter” 的插件。前者已停更,后者不支持 null safety 后的语法,required、??=、泛型推导都会报红或跳转失效。
- 通过
Package Control → Install Package搜索Dart,认准作者字段 - 装完必须重启 Sublime,否则
.dart文件不会自动启用语法高亮 - 如果右下角没显示
Dart,右键文件 →Open all with current extension as → Dart
dart_sdk_path 填什么、为什么容易错
这个配置不是必须填,但填错会直接导致分析服务器启动失败,表现为 Unable to locate SDK 或 Failed to start the Dart analysis server。优先走系统 PATH,其次才手动指定路径。
- Flutter 自带 Dart SDK,路径通常是:
/path/to/flutter/bin/cache/dart-sdk(macOS/Linux)或C:\flutter\bin\cache\dart-sdk(Windows) - 别单独下载另一个 Dart SDK,版本不匹配会导致
analysis_server.dart.snapshot找不到 - 填完后必须执行
Ctrl+Shift+P → Dart: Restart Analysis Server,等状态栏出现Analysis server ready - 如果仍失败,删掉
dart_sdk_path这行,改在 Sublime 的Preferences → Settings – User里加"path": "/your/flutter/bin"更稳
为什么 Ctrl+Click 跳不到定义、补全不弹
不是插件坏了,是分析服务器没起来,或者它压根没连上正确的 SDK。跳转和补全依赖 dartanalyzer 启动成功,而它对路径和命令权限很敏感。
- 终端先确认
which dart有输出,且dart --version能返回版本号 - Sublime 内置控制台(
Ctrl+`)里如果看到Cannot find 'dart',说明插件没读到系统PATH,得手动在用户设置里补全path - 右键
Go to Definition失效?检查插件设置里"use_legacy_analysis_server"是否为false,legacy 模式对 Flutter 项目支持差,尤其package:flutter引用会跳空 - 补全不自动弹?默认要保存后才触发,或手动调
Ctrl+Shift+P → LSP: Auto Complete(如果你装了 LSP-dart)
保存自动格式化怎么开、为什么没反应
格式化靠两层开关:插件级控制 + 编辑器级触发。只开一个,保存时就静悄悄。
- 在
Preferences → Package Settings → Dart → Settings – User里确保同时存在:"dart_format_on_save": true和"format_on_save": true - 如果用了自定义
analysis_options.yaml,格式化结果可能和 VS Code 不一致——这是预期行为,不是 bug - 格式化卡住?先
Dart: Restart Analysis Server,再试保存 - 不想依赖插件?可手建构建系统:
Tools → Build System → New Build System,填入:{"cmd": ["dart", "format", "$file"], "selector": "source.dart"},之后Ctrl+B手动格式化
最常被忽略的是:Sublime 不解析 pubspec.yaml,不识别 lib/ 是源码目录,也不管你有没有 main.dart。所有“项目感知”都靠你手动建 .sublime-project 文件声明结构,否则 import 补全和测试文件识别会断掉。

















