Sublime Text 4 启动后找不到 dart 命令,需在 Settings – User 中配置 "path" 字段为实际 dart/flutter/bin 路径并彻底重启;再禁用 legacy 分析服务器、正确设置 dart_sdk_path 指向 flutter/bin/cache/dart-sdk,最后安装 LSP + LSP-dart 并手动指定 command 路径以启用补全。

Sublime Text 4 启动后找不到 dart 命令?先改 path 设置再重启
GUI 启动的 Sublime Text 4 不继承终端环境变量,哪怕你在 ~/.zshrc 或 PATH 里配好了 dart 和 flutter,它也看不到。这不是插件问题,是启动上下文隔离导致的。
- 在终端运行
which dart和which flutter,记下输出路径(如/opt/homebrew/bin/dart、/Users/xxx/flutter/bin) - 打开 Sublime → Preferences → Settings – User,添加这一行:
"path": "/opt/homebrew/bin:/Users/xxx/flutter/bin:/Users/xxx/flutter/bin/cache/dart-sdk/bin" - 多个路径用英文冒号分隔,Windows 用户用分号
- 必须彻底关闭并重新打开 Sublime Text 4(不是重载设置),否则
path不生效 - 重启后按
Ctrl+Shift+P输入Dart: Restart Analysis Server,看状态栏是否出现Analysis server ready
Ctrl+Click 跳不到 Text 或 MaterialApp?关 legacy 分析服务器 + 正确填 dart_sdk_path
旧版分析服务器(use_legacy_analysis_server)对 Flutter 导入路径解析极差,尤其遇到 package:flutter/material.dart 这类别名导入时,直接返回空结果或跳到空白文件。
- 打开 Preferences → Package Settings → Dart → Settings – User
- 确保包含:
"use_legacy_analysis_server": false -
"dart_sdk_path"必须指向flutter/bin/cache/dart-sdk目录(不是flutter/根目录,也不是dart-sdk/bin) - 删掉
"flutter_sdk_path"或任何其他 SDK 路径字段——它们已废弃且易冲突 - 保存后再次执行
Dart: Restart Analysis Server,同时打开控制台(Ctrl+`)确认无Failed to start the Dart analysis server
补全不弹、required 参数没提示?换 LSP-dart,别信原生 Dart 插件
原生 Dart 插件的补全在 Dart 2.12+ 后就失效了,它依赖的协议已被弃用。你按 Ctrl+Space 没反应,不是键盘问题,是服务根本没返回数据。
- 用 Package Control 安装两个插件:
LSP和LSP-dart(缺一不可) - 确保终端能跑通
dart --version;否则LSP-dart启动失败,右下角不会显示LSP-dart - 打开 Preferences → Package Settings → LSP → Settings,手动指定:
"command": ["/Users/xxx/flutter/bin/cache/dart-sdk/bin/dart"](不能只写"dart") - 补全不会自动弹出,需手动触发:
Ctrl+Shift+P→LSP: Auto Complete,或保存后等 2–3 秒再按Ctrl+Space -
WidgetsBinding.instance、Scaffold.of等 Flutter 特有 API 基本不识别——LSP-dart对 package:flutter 的支持仍很弱
怎么加 dart analyze 实时 Lint?装 SublimeLinter-contrib-dart 并确认 dart 可达
Sublime 本身不带静态分析能力,SublimeLinter-contrib-dart 是唯一能对接 dart analyze 的方案,但它完全依赖 dart 命令是否可用。
- 用 Package Control 安装
SublimeLinter和SublimeLinter-contrib-dart - 确认 Sublime 已通过
path设置或LSP配置让dart命令全局可达 - 打开任意
.dart文件,修改一行代码引入未使用变量,看左侧行号旁是否出现黄色波浪线 - 若无反应,打开控制台(
Ctrl+`),搜索sublimelinter相关报错,大概率是dart找不到或版本太低(需 Dart ≥ 2.14) - 不建议全局启用
dart format保存钩子——混着.yaml或.json的项目会误触发报错
最常被忽略的一点:所有配置项里路径多一个斜杠、少一个字符,或者没重启 Sublime Text 4,都会让整个链路静默失败。它不像 VS Code 那样容错,每一步都得对得严丝合缝。


















