不喜欢广告? 去 无广告 今天
Dart 代码格式化工具
开发人员文本
广告 移除?
广告 移除?
指导
Dart 代码格式化工具
粘贴您的 Dart 或 Flutter 源码,立即获得一个符合规范的整洁版本,该版本遵循由 dart format强制执行的规范。此格式化器完全在您的浏览器中运行——无需安装 SDK,无需上传,也无需等待远程服务器。它是一个快速、确定性的辅助工具,适用于您希望在不离开页面的情况下获得符合规范输出的任何情况。
如何使用
- 将您的 Dart 或 Flutter 代码粘贴到输入区域,或点击 尝试一个示例 加载示例。
- 选择您偏好的缩进大小(2 个空格是 dart_style 的默认值,但 4 个空格和制表符也受支持)。
- 拖动 行长度 滑块——当行长度超过目标值时,格式化器将向您发出警告。
- 切换 排序和分组指令, 添加尾随逗号,并且 合并空行 根据需要。
- 点击 格式 并复制或下载清理后的源码。
特征
- 可配置的行长度 ——从 40 到 160 个字符的滑块,默认为官方的 80。
- 受 dart_style 启发的缩进 ——支持 2 个空格、4 个空格或制表符。
- 指令分组 ——排序和分组
dart:,package:,以及相对导入,组间用空行分隔。 - 尾随逗号 ——在多行参数和参数列表末尾添加尾随逗号,这与 Flutter 组件树的期望完全一致。
- 支持空值安全 ——保留
?.,!,??,并且??=并正确缩进。 - 字符串安全 ——单引号、双引号、三引号和原始(
r"…")字符串字面量保持不变。 - 注释安全 ——行注释、块注释和 DartDoc(
///)注释被保留并清晰重排。 - 顶层间距 ——在顶层声明之间插入空行以提高可读性。
- 100% 客户端 ——您的代码不会离开浏览器,因此适用于专有代码。
用例
- 快速清理 从 Stack Overflow 答案或聊天消息中复制的代码片段。
- 代码审查 在 GitHub 或 GitLab 上,您希望在评论前比较标准化输出。
- 新员工入职培训 尚未安装本地 Dart SDK 的新开发人员。
- 预提交检查 当您希望将编辑器的输出与另一个意见的格式化器进行比较时。
- Flutter 组件树 其中一致的尾随逗号能有效降低差异噪声。
常问问题
-
该格式化器遵循什么风格?
该格式化器模仿了由
dart format(Dart SDK 的官方工具)强制执行的规范,受 dart_style 包启发。它目标是 80 个字符的默认行长度,使用两个空格缩进,规范化操作符间距,并按标准顺序对指令进行分组:dart:、包:、然后是相对导入。 -
为什么在 Dart 和 Flutter 中尾随逗号很重要?
多行参数或参数列表末尾的尾随逗号会通知格式化器将每个元素单独放在一行。在 Flutter 组件树中,这极大地提高了可读性,并产生更清晰的差异,因此官方 Dart 风格指南建议,任何跨越多行的列表都应使用尾随逗号。
-
什么是 dart_style?
dart_style 是一个开源的 Dart 包,为
dart format、Android Studio、IntelliJ 和 VS Code 中的 IDE 格式化器,以及 dartpad.dev 上的格式化器提供支持。它采用确定性、单一风格的算法,因此任何两个正确格式化的 Dart 文件在外观上都完全相同,无论谁编写。 -
空值安全运算符(如 ??、?。和 !)如何影响格式化?
空值感知运算符会紧贴其操作数:
?.且!不会在周围添加空格,而??且??=则像二元运算符一样,每个侧边只加一个空格。这与空值安全代码中 dart_style 的行为一致。
