# Scalafmt 格式化程序

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件：   Scala  ： [安装方法](get-started-with-scala.html#scala_plugin)

您可以在项目中启用 [Scalafmt](https://scalameta.org/scalafmt/) 格式化器，而不是默认的 IntelliJ IDEA 格式化器。

## 配置 Scalafmt

Procedure: 启用格式化程序

1. 在   设置   对话框（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `编辑器 | 代码样式 | Scala` 。

2. 在   格式化器   下拉菜单中，选择   Scalafmt  。

格式化程序字段下的标签列表会相应更新。

![Scalafmt 设置](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-and-test-scala.html)时重新格式化文件。

* 配置 ：如果 IntelliJ IDEA 没有在您的项目中找到具有指定格式化程序版本的 `.scalafmt.conf` 文件，它将使用当前 [默认的 Scalafmt 版本](https://github.com/scalameta/scalafmt/blob/v1.5.1/scalafmt-core/shared/src/main/scala/org/scalafmt/config/Settings.scala#L19)。 您可以 [override the default version](#change_scalafmt)。

> **Note:**
> IntelliJ IDEA 会将此配置保存到当前项目。 如果想将这些设置用作新项目的默认设置，请转到  `文件 | 新建项目设置 | 新项目偏好设置（针对新项目）作成新项目用偏好设置`  并保存您的 Scalafmt 配置。

Procedure: 覆盖 Scalafmt 版本

1. 在您的项目根目录下创建  `.scalafmt.conf`  文件。 右键点击您的项目并选择  `新建 | 文件` 。

![Scalafmt 配置文件](https://resources.jetbrains.com/help/img/idea/2026.3/new_scalafmt_config.png)

2. 在编辑器中打开配置文件，指定要使用的 Scalafmt 版本以及其他格式设置选项。

3. 访问 [Scala formatter settings](#scalafmt_config)。 IntelliJ IDEA 会在   配置   选项下反映您对 Scalafmt 的更改。

![更改版本的 Scalafmt 设置](https://resources.jetbrains.com/help/img/idea/2026.3/scalafmt_settings_changed_version.png)

> **Note:**
> 当使用 Scalafmt 进行格式化时，所有 IntelliJ IDEA 常规格式化程序选项将被忽略，代码格式设置将交由 Scalafmt 处理。

## 使用 Scalafmt 重新格式化代码。

请注意，Scalafmt 格式化程序只能应用于整个文件。 如果需要重新格式化更小的代码片段，将会 [由 IntelliJ IDEA 重新格式化](#idea_formatter)。

Procedure:

1. 在编辑器中打开您想要重新格式化的文件。

2. 在主菜单中，转到  `编码 | 重新格式化文件` （ `Ctrl+Alt+Shift+L` (Windows), `⌘ ⌥ ⇧ L` (macOS), `⌘ ⌥ ⇧ L` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ ⇧ L` (macOS System Shortcuts), `Ctrl+Alt+Shift+L` (XWin), `Ctrl+Alt+Shift+L` (GNOME), `Ctrl+Alt+Shift+L` (KDE), `Ctrl+Alt+Shift+L` (Emacs), `Ctrl+Alt+Shift+L` (Sublime Text), `⌘ ⌥ ⇧ L` (Sublime Text (macOS)), `Ctrl+Alt+Shift+L` (Visual Studio), `⌘ ⌥ ⇧ L` (Visual Studio (macOS)), `Ctrl+Alt+Shift+L` (NetBeans), `Ctrl+Alt+Shift+L` (Eclipse), `⌘ ⌥ ⇧ L` (Eclipse (macOS))），并在   重新格式化文件   对话框中调整设置。

3. 点击   运行  。

![文件重格式化对话框](https://resources.jetbrains.com/help/img/idea/2026.3/Reformat_file_dialog.png)

有关更多信息，请参阅 [重新格式化代码](reformat-and-rearrange-code.html)。