如何在Sublime Text中解决Dart代码无法格式化的问题？

开发者阿泽

2026-7-9

解决Sublime Text中Dart代码格式化问题

新版Dart已将格式化工具整合到dart命令中，旧的dartfmt命令被移除，你安装的CodeFormatter插件默认仍在调用dartfmt，因此出现报错。以下是两种可行的解决方法：

方法一：配置CodeFormatter插件使用`dart format`

打开Sublime Text，依次点击 Preferences -> Package Settings -> CodeFormatter -> Settings - User

在配置文件中添加或修改Dart的格式化规则：

{
    "codeformatter_dart_options": {
        "command": "dart",
        "args": ["format", "-"],
        "line_length": 80, // 可根据需求自定义代码行长度
        "use_local_config": true // 启用后会读取项目根目录的analysis_options.yaml配置
    }
}

保存配置并重启Sublime Text，即可正常使用格式化功能。

方法二：自定义Build System实现格式化

点击 Tools -> Build System -> New Build System

将默认内容替换为以下代码：

{
    "cmd": ["dart", "format", "$file"],
    "selector": "source.dart",
    "quiet": true,
    "working_dir": "$file_path"
}

将文件保存为Dart Format.sublime-build（保存路径保持默认的Packages/User即可）
使用时，先选中该Build System（Tools -> Build System -> Dart Format），按Ctrl+B（Windows/Linux）或Cmd+B（Mac）即可格式化当前文件。也可绑定快捷键，在 Preferences -> Key Bindings 中添加：
```
{ "keys": ["ctrl+shift+f"], "command": "build", "args": {"variant": ""} }
```

额外检查

若以上方法无效，确认Sublime Text能访问dart命令：

打开Sublime控制台（按Ctrl+），输入以下代码回车：
```
import os; print(os.environ['PATH'])
```
对比终端echo $PATH（Mac/Linux）或echo %PATH%（Windows）的输出，若Flutter的bin目录不在Sublime的PATH中，在 Preferences -> Settings - User 中添加路径：
```
"paths": ["/你的Flutter安装路径/bin"]
```