Kotlin 代码格式化工具
指导
Kotlin 代码格式化工具
粘贴任何 Kotlin 源代码，即可在浏览器中获得干净的、符合 ktlint 风格的格式化结果。该格式化器会规范化缩进、修复操作符间距、排序导入，并在多行列表中添加尾随逗号，整个过程无需将代码发送到服务器。
如何使用
- 将您的 Kotlin 代码粘贴到输入框中，或点击 尝试一个示例 加载示例文件。
- 选择缩进大小（2 个空格、4 个空格或制表符）以及最大行宽。
- 切换 排序导入 且 添加尾随逗号 根据您的偏好设置。
- 点击 格式 并复制或下载清理后的输出。
特征
- 可配置的缩进 – 在 2 个空格、4 个空格或制表符之间切换，无需重新编辑文件。
- 操作符间距 – 操作符周围保持一致的空白
=,==,===,->,?:，以及复合赋值。 - 导入排序 – 按全路径字母顺序排列
import声明为一个块。 - 尾随逗号 – 在多行参数和参数列表中自动添加。
- 大括号位置 – 大括号保持在声明同一行，符合 Kotlin 习惯。
- 字符串与注释安全 – 字符串字面量、KDoc 和块注释中的标记将原样保留。
- 仅客户端 – 您的代码不会离开浏览器；没有上传，没有日志。
- 复制与下载 – 可以将结果以文本形式获取，或保存为
.kt文件。
何时使用此工具
此格式化器适用于运行完整 ktlint 或 ktfmt 工具链过于繁琐的情况：粘贴聊天或拉取请求线程中的代码片段、清理一次性 Gist 内容，或为文档标准化示例。它应用在代码审查中最常出现的规则——冒号周围的不一致空格、顶级声明之间缺少空行、编辑后缩进层级不匹配——并将更深层的语义转换留待 IDE 处理。
常问问题
-
Kotlin 代码格式化遵循什么风格指南？
Kotlin 代码格式化遵循 JetBrains 发布的官方 Kotlin 编码规范。这些规范涵盖缩进（4 个空格，不使用制表符）、大括号与声明在同一行、多行列表中的尾随逗号，以及公共、开放、重写和挂起等修饰符的规范排序。ktlint 和 ktfmt 等工具会强制执行这些规则的变体，以确保团队间的代码库保持一致。
-
Kotlin 导入如何组织？
Kotlin 导入通常被组织为文件顶部的一个块，位于包声明下方，导入之间不保留空行。规范要求按完整路径字母顺序排序。星号导入允许但不推荐用于存在歧义的包；对于 kotlinx.android.synthetic 等生成包的星号导入是常见例外。
-
为什么尾随逗号在 Kotlin 中有用？
在多行参数列表、参数列表和集合字面量中使用尾随逗号，可以减少在添加或重新排序项目时的差异噪音，因为无需修改闭括号上方的行来添加逗号。从 Kotlin 1.4 开始，尾随逗号已成为语言语法的一部分，ktlint 鼓励在跨越多行的列表中使用尾随逗号。
-
Kotlin 如何处理行长度和换行？
Kotlin 官方指南建议最大行长度为一百到一百二十个字符。当声明超过此限制时，参数和链式方法调用通常会被拆分到不同行，且续行缩进一个额外层级。大括号保持与闭括号在同一行，以保持声明的视觉紧凑性。
