ktfmt is a program that pretty-prints (formats) Kotlin code, based on google-java-format.
ktfmt still has some rough edges which we're constantly working on fixing.
The minimum supported runtime version is JDK 11, released September 2018.
|Before Formatting||Formatted by |
For comparison, the same code formatted by
ktlint and IntelliJ:
|Formatted by ||Formatted by IntelliJ|
A ktfmt IntelliJ plugin is available from the plugin repository. To install it, go to your IDE's settings and select the
Plugins category. Click the
Marketplace tab, search for the
ktfmt plugin, and click the
The plugin will be disabled by default. To enable it in the current project, go to
File→Settings...→ktfmt Settings (or
IntelliJ IDEA→Preferences...→Editor→ktfmt Settings on macOS) and check the
Enable ktfmt checkbox. (A notification will be presented when you first open a project offering to do this for you.)
To enable it by default in new projects, use
File→New Project Settings→Preferences for new Projects→Editor→ktfmt Settings.
When enabled, it will replace the normal
Reformat Code action, which can be triggered from the
Code menu or with the Ctrl-Alt-L (by default) keyboard shortcut.
To configure IntelliJ to approximate ktfmt‘s formatting rules during code editing, you can edit your project’s
.editorconfig file to include the Kotlin section from one of the files inside
docs/editorconfig. Not all of ktfmt‘s rules can be represented as IntelliJ editor settings, so you will still need to run ktfmt. Alternately, that file can be used as a reference to manually change the project’s code style settings.
Download the formatter and run it with:
java -jar /path/to/ktfmt-<VERSION>-jar-with-dependencies.jar [--dropbox-style] [files...]
ktfmt use a block indent of 4 spaces instead of 2. See below for details.
Note: There is no configurability as to the formatter's algorithm for formatting (apart from
--dropbox-style). This is a deliberate design decision to unify our code formatting on a single format.
A Gradle plugin (ktfmt-gradle) is available on the Gradle Plugin Portal. To set it up, just follow the instructions in the How-to-use section.
Alternatively, you can use Spotless with the ktfmt Gradle plugin.
Consider using Spotless with the ktfmt Maven plugin.
ktfmt uses google-java-format's underlying engine, and as such, many items on google-java-format's FAQ apply to
ktfmt as well.
ktfmtignores most existing formatting. It respects existing newlines in some places, but in general, its output is deterministic and is independent of the input code.
ktfmtexposes no configuration options that govern formatting behavior. See https://github.com/google/google-java-format/wiki/FAQ#i-just-need-to-configure-it-a-bit-differently-how for the rationale.
These two properties make
ktfmt a good fit in large Kotlin code bases, where consistency is very important.
ktlint and IntelliJ sometime fail to produce nice-looking code that fits in 100 columns, as can be seen in the Demo section.
ktfmtuses a 2-space indent; why not 4? any way to change that?
Two reasons -
However, we do offer an escape-hatch for projects that absolutely cannot make the move to
ktfmt because of 2-space: the
--dropbox-style flag changes block indents to 4-space.
pom.xmlin IntelliJ. Choose “Open as a Project”
java -jar core/target/ktfmt-<VERSION>-jar-with-dependencies.jar
Apache License 2.0