简介

作为一名 Android 开发者，保持代码风格的一致性和良好的可读性是非常重要的。Android Studio 提供了强大的代码格式化功能，可以帮助我们自动整理代码结构，使其符合标准编码规范。本文将详细介绍如何在 Android Studio 中进行全局代码格式化。

一、代码格式化的重要性

统一的代码格式有以下几个重要作用：

提升代码可读性：统一的缩进、空格和换行让代码结构更清晰
便于团队协作：统一的编码规范让团队成员更容易理解和维护彼此的代码
减少错误：良好的代码结构有助于发现潜在问题
提高开发效率：标准化的代码更容易进行代码审查和重构

二、Android Studio 代码格式化方法

1. 快捷键格式化

这是最快捷的代码格式化方式，支持不同操作系统：

Windows/Linux：Ctrl + Alt + L
macOS：Option + Cmd + L

使用方法：

打开需要格式化的文件
按下对应的快捷键
代码将自动按照预设格式重新排列

2. 菜单栏格式化

通过菜单选项进行代码格式化：

打开需要格式化的文件
点击顶部菜单栏的 Code
选择 Reformat Code 选项

3. 高级格式化选项

使用 Ctrl + Shift + Alt + L（Windows/Linux）或 Cmd + Option + L（macOS）可以打开格式化对话框，提供更多自定义选项：

优化导入：自动删除未使用的导入语句，添加缺失的导入
重新排列条目：根据代码风格设置重新排序代码元素
代码清理：运行代码清理检查
不保留换行符：根据代码风格设置重新格式化换行符

三、全局代码格式化设置

1. 访问代码风格设置

打开 Settings/Preferences（Ctrl + Alt + S 或 Cmd + ,）
导航到 Editor → Code Style
选择对应的语言（如 Java、Kotlin、XML 等）

2. 代码风格方案

Android Studio 提供两种预定义的代码风格方案：

Project 方案：仅应用于当前项目，存储在项目目录中，可通过版本控制系统共享
Default 方案：应用于所有项目，存储在 IDE 配置目录中

3. 方案管理

可以通过方案下拉菜单旁边的齿轮图标管理代码风格方案：

复制到 IDE：将项目方案复制为 IDE 级别方案
导出方案：将选定方案导出为 XML 或 EditorConfig 格式
导入方案：从指定位置导入代码风格方案
复制到项目：使用 IDE 级别方案覆盖当前项目设置
复制方案：创建选定方案的副本
重置：将默认或捆绑方案重置为初始默认值

四、自动格式化功能

1. 保存时自动格式化

可以配置 Android Studio 在保存更改时自动格式化代码：

打开 Settings/Preferences
导航到 Tools → Actions on Save
启用 Reformat code 选项
可以进一步配置格式化范围和文件类型

2. 提交时自动格式化

如果项目使用版本控制，可以在提交更改时自动格式化代码：

打开 Commit 工具窗口（Alt + 0）
点击 Show Commit Options
在 Commit Checks 菜单中启用 Reformat code 选项

五、自定义格式化规则

1. 行分隔符设置

在 Code Style 的 General 选项卡中，可以配置行分隔符：

System-Dependent：使用操作系统默认分隔符
Unix and macOS：使用 Unix/macOS 行分隔符
Windows：使用 Windows 行分隔符

2. 缩进检测

可以选择 Detect and use existing file indents for editing 来检测当前文件的缩进风格，并使用该风格而不是在代码风格设置中指定的缩进。

3. 排除文件格式化

在 Formatter 选项卡中，可以在 Do not format 字段中指定要排除格式化的文件和目录的 glob 模式。

4. 使用格式化标记

启用 Turn formatter on/off with markers in code comments 选项后，可以在代码中使用标记来控制格式化：

@formatter:off：标记格式化关闭的开始位置
@formatter:on：标记格式化关闭的结束位置

六、最佳实践建议

团队统一规范：与团队成员协商制定统一的代码风格规范
定期格式化：养成定期格式化代码的习惯
使用版本控制：通过版本控制系统共享项目级别的代码风格设置
合理配置自动格式化：根据项目需求合理配置保存时或提交时的自动格式化功能
了解快捷键：熟练掌握常用的格式化快捷键，提高开发效率

通过合理使用 Android Studio 的代码格式化功能，我们可以显著提升代码质量和开发效率，同时保证团队代码风格的一致性。
参考文章：
https://www.jianshu.com/p/8f982253eb9e

Androidstudio如何全局代码格式化