Eclipse 提供了非常强大和灵活的代码格式化功能，我们可以分为三个层面来掌握它：
- 基本操作： 如何手动格式化代码。
- 自动格式化： 如何在保存或输入时自动格式化。
- 自定义规则： 如何配置符合你或团队偏好的格式化规则。
基本操作：手动格式化代码
这是最常用、最直接的方法。
使用菜单栏
- 选中你想要格式化的代码（可以是一行、一个方法、一个类，或整个文件）。
- 点击顶部菜单栏的 Source -> Format。
使用快捷键（强烈推荐）
快捷键是最高效的方式,默认的快捷键是：
- Windows/Linux:
Ctrl + Shift + F - Mac:
Cmd + Shift + F
提示：
- 如果你没有选中任何代码,快捷键会格式化整个文件。
- 如果你只选中了一部分代码,快捷键只会格式化你选中的部分。
使用右键菜单
- 在编辑器中右键点击。
- 选择 Source -> Format。
自动格式化：设置“保存时自动格式化”
这是一个非常好的习惯,可以确保你提交的代码总是符合格式规范，避免忘记手动格式化。
- 点击顶部菜单栏的 Window -> Preferences (在 macOS 上是 Eclipse -> Preferences)。
- 在弹出的窗口中,导航到 Java -> Editor -> Save Actions。
- 勾选 Perform the following actions on save。
- 在下方的列表中,勾选
Format source code。 - （可选，但推荐）同时勾选 Organize imports，这会在保存时自动整理和优化 import 语句。
- 点击 Apply and Close。
从此以后，只要你按 Ctrl + S (或 Cmd + S) 保存文件，Eclipse 就会自动帮你格式化代码。
自定义格式化规则：打造你的代码风格
Eclipse 的默认格式化规则可能不完全符合你的个人或团队的偏好，你可以进行深度自定义。
如何进入格式化设置
- 点击 Window -> Preferences。
- 导航到 Java -> Code Style -> Formatter。
- 你会看到当前正在使用的配置文件。
如何修改现有配置
- 在右侧的 Active profile 列表中，选择一个配置（
Eclipse [built-in]）。 - 点击 Edit... 按钮。
- 你会看到一个详细的设置窗口,包含了所有可配置的规则。
核心配置项详解
在 Edit Formatter 窗口中，你可以配置以下几大类规则：
a) 代码缩进
- Tab policy: 选择使用
Tab字符还是Spaces(空格)。强烈建议团队统一使用Spaces，因为这样可以避免在不同编辑器中显示不一致。 - Indentation size: 设置缩进的空格数（通常是 2 或 4）。
- Tab size: 设置一个
Tab字符等于多少个空格（当使用Tab字符时）。
b) 换行和括号
- Line wrapping: 控制代码行的最大长度，以及何时换行。
- Braces: 这是非常重要的一项！
- Next line: 左大括号 放在上一行的末尾。
if (condition) { // code } - Next line when wrapping: 只有在换行时，左大括号才放到下一行。
- Same line: 左大括号 和它所属的语句在同一行，这是 Java 最常见的风格。
if (condition) { // code } - 你可以分别设置
Class declaration,Method declaration,For statement等不同场景下的括号位置。
- Next line: 左大括号 放在上一行的末尾。
c) 空白
- Blank lines: 控制方法之间、类之间是否插入空行。
- Spaces: 控制在操作符（如 , ）、逗号、括号等周围是否插入空格。
if (x > 0)vsif(x>0)。
d) 其他常用设置
- Number of blank lines before imports: import 语句前保留的空行数。
- Comment formatting: 控制注释的格式，如是否自动换行等。
如何保存和分享你的配置
- 在 Formatter 设置窗口中，完成你的自定义修改后，点击 OK。
- 回到主 Formatter 窗口，点击 Export... 按钮。
- 将配置文件保存为一个
.xml文件（my-codestyle.xml）。 - 你可以将这个
.xml文件分享给你的团队成员，他们只需要：- 打开 Formatter 设置窗口。
- 点击 Import... 按钮。
- 选择你分享的
.xml文件。 - 导入后,将其设置为
Active profile即可。
这样,整个团队就能使用完全一致的代码格式化规则了。
高级技巧：使用 Google 或其他代码风格模板
很多大型项目（如 Google, Spring）都有公开的代码风格规范，Eclipse 允许你直接导入这些预设的模板。
- 在 Formatter 设置窗口中，点击 Import...。
- 在弹出的窗口中,选择 Get more profiles from...。
- 你会看到一个列表,其中包含了 Google, Spring 等流行项目的代码风格模板，选择你需要的并下载导入即可。
导入 Google Java Style 后，你的代码会自动按照 Google 的规范进行格式化，
- 左大括号总是在同一行。
- 缩进使用 4 个空格。
- 运算符两边有空格,逗号后面有空格。
| 功能 | 操作 | 用途 |
|---|---|---|
| 手动格式化 | Ctrl + Shift + F 或 Source -> Format |
快速修复当前代码的格式。 |
| 自动格式化 | Window -> Preferences -> Java -> Editor -> Save Actions |
确保每次保存都符合规范，防止遗忘。 |
| 自定义规则 | Window -> Preferences -> Java -> Code Style -> Formatter |
打造符合个人或团队偏好的代码风格。 |
| 分享规则 | 导出/导入 .xml 配置文件 |
在团队中统一代码风格，提高协作效率。 |
掌握这些 Eclipse Java 格式化技巧，将极大地提升你的编码效率和代码质量。
