JetBrains IDE 怎样只格式化选中的代码范围

在 JetBrains IDE 里只格式化一段代码，关键不是先找快捷键，而是先保留准确的选区。选中代码后打开 Code | Reformat Code，或使用当前 Keymap 中的 Reformat Code 快捷键，IDE 就会把格式化范围限制在选区；没有选区时，默认目标会变成整个文件。

官方文档：https://www.jetbrains.com/help/idea/reformat-and-rearrange-code.html

Windows/Linux 默认快捷键是 Ctrl+Alt+L，macOS 是 ⌘⌥L。不同 JetBrains 产品或自定义 Keymap 可能存在差异，因此本文把菜单路径作为最稳定的兜底入口。下面用“选中一段方法、保留文件其它部分不变”的场景完成一次操作和验收。

先确认选区，而不是直接按格式化快捷键

格式化范围由“当前选区”决定。光标只停在某一行、但没有高亮选区时，不要把它理解成“只格式化当前行”；在很多场景下，直接执行 Reformat Code 会按文件级范围处理。先用鼠标拖选目标代码，或把光标放进目标结构后使用 Ctrl+W（macOS 可使用对应的扩大选择快捷键）逐级扩大到方法、代码块或其它语法结构。

1. 在 Project 视图或编辑器中打开目标文件。
2. 拖选需要整理的代码片段，确保选区从第一行开始并覆盖到最后一行。
3. 检查选区外是否仍有一段未高亮的代码，尤其留意文件顶部的导入区和相邻方法。
4. 如果只是想调整缩进，不要误用完整格式化；可以改用缩进相关动作，再按结果验收。

这一小步的验收标准很简单：编辑器中只有目标片段高亮，选区外的代码没有被临时加入选择。选区不清楚时先不要执行，重新选择比事后检查整文件差异更省时间。

用 Code 菜单只格式化当前选区

1. 保持选区不变，点击顶部菜单 Code。
2. 选择 Reformat Code。如果菜单中显示了快捷键，也以当前界面显示为准。
3. 在 Windows/Linux 上可以直接按 Ctrl+Alt+L，macOS 使用 ⌘⌥L。
4. 等待编辑器完成排版，观察缩进、换行、括号和空格是否按照当前代码样式更新。

JetBrains 文档把“选中代码片段”和“未选择代码”区分开：前者格式化片段，后者通常按整个文件处理。不要因为快捷键执行成功，就认为范围一定正确；真正的成功状态是目标片段变化、选区外没有被连带改写。

看到 Reformat File 对话框时先停一下

如果你从 Project 工具窗口对文件、目录或模块执行 Reformat Code，或者使用了打开整文件设置的入口，可能会看到 Reformat File 对话框。这和编辑器中直接格式化选区不是同一个操作层级。

对话框里常见的选项包括优化导入、重排条目、代码清理和是否保留换行。它们可能扩大修改范围，所以处理单个选区时应先确认当前入口确实来自编辑器选区，而不是 Project 视图的文件级、目录级操作。

用差异和 Local History 验收格式化结果

格式化完成后不要只看光标附近。可以按下面的顺序验收：

1. 先看选区外：滚动到相邻方法、文件顶部导入区和文件末尾，确认没有出现预期之外的换行或重排。
2. 再看代码样式：确认缩进、括号、换行和空格与项目约定一致。如果项目使用 .editorconfig，还要注意它与 IDE 项目设置的优先关系。
3. 再看版本差异：通过 Git diff 对比实际变更；格式化任务的差异应集中在选区附近。
4. 最后留回退点：若范围不对，立即撤销；若已经继续编辑，可用 Local History 找回格式化前的状态。

不要用“没有报错”作为唯一结论。格式化通常不会产生运行时错误，范围是否正确只能靠选区外对照和版本差异确认。

快捷键失效或格式结果不一致怎么办

• 快捷键没有反应：先走 Code | Reformat Code。如果菜单可用，说明功能正常，问题通常在 Keymap 冲突、系统快捷键或输入法。
• 快捷键执行了其它功能：打开 Settings/Preferences | Keymap，搜索 Reformat Code，查看当前绑定并重新分配一个未占用的组合键。
• 格式化后和团队结果不同：检查 Settings/Preferences | Editor | Code Style，以及项目里的 .editorconfig。先统一方案，再重新格式化，不要靠手工补空格。
• 只想改缩进：不要开启整文件的优化导入、重排或代码清理；回到目标选区，使用与缩进相关的动作。
• 选区外也有变化：立即撤销，重新从编辑器建立选区，并避免从 Project 视图的文件或目录入口执行。

一张表记住正确范围

因此，JetBrains IDE 只格式化选中代码的最短路径是：在编辑器建立明确选区，执行 Code | Reformat Code，再通过选区外对照和 Git diff 验收。如果快捷键有冲突，菜单入口仍然可用；如果格式结果不一致，优先统一 Code Style 和 .editorconfig，不要把问题归咎于选区功能本身。

相关问题

没有选中代码时按 Ctrl+Alt+L 会怎样？

通常会按当前文件范围执行格式化。若目标是局部整理，应先建立选区再执行。

能不能只格式化当前方法？

可以，把方法完整选中后执行 Reformat Code；也可以先把光标放入方法并使用语法感知的扩大选择，再检查高亮边界。

为什么格式化后导入也变了？

可能是从文件级入口执行，或对话框启用了优化导入。撤销后回到编辑器选区入口，并在需要时关闭会扩大修改范围的选项。