IDEA效率跃迁（1）之Save Actions插件：从安装到自动化编码规范
1. 为什么你需要Save Actions插件
作为一名长期使用IntelliJ IDEA进行开发的程序员，我深刻体会到编码规范的重要性。但手动维护代码格式、优化导入语句这些琐事，往往会打断我们的编程思路。这就是Save Actions插件存在的意义——它能在你保存文件时自动完成这些机械性工作。
记得刚开始用IDEA时，每次写完代码都要手动按Ctrl+Alt+L格式化，还要时不时清理无用的import语句。后来团队引入了代码审查，经常因为格式问题被打回修改，浪费了大量时间。直到发现了Save Actions这个神器，这些问题才迎刃而解。
Save Actions的核心价值在于将代码规范检查从"事后补救"变成了"实时维护"。它会在你保存文件时自动执行预设的代码优化操作，确保每一行代码都符合规范。这不仅提高了代码质量，还省去了大量重复劳动。
2. 安装Save Actions的三种方式
2.1 通过插件市场直接安装
这是最推荐的方式，简单快捷：
- 打开IDEA，点击菜单栏的File → Settings（Windows/Linux）或IntelliJ IDEA → Preferences（Mac）
- 选择Plugins → Marketplace
- 在搜索框输入"Save Actions"
- 找到插件后点击Install按钮
- 安装完成后重启IDEA
我实测过多次，整个过程通常不超过2分钟。但有时会遇到网络问题导致安装失败，这时候可以尝试下面两种方法。
2.2 手动下载插件包安装
如果市场安装失败，可以到JetBrains插件官网下载：
- 访问https://plugins.jetbrains.com/plugin
- 搜索"Save Actions"
- 选择与你的IDEA版本兼容的插件版本下载
- 回到IDEA的Plugins界面，点击齿轮图标选择"Install Plugin from Disk"
- 选择下载的zip文件完成安装
2.3 通过Gradle/Maven配置安装
对于团队项目，可以在构建脚本中加入插件依赖：
// build.gradle plugins { id 'org.jetbrains.intellij' version '1.13.3' id 'java' } intellij { plugins = ['Save-Actions:1.9.0'] }这种方式适合需要统一团队开发环境的场景。
3. 基础配置：让插件开始工作
安装完成后，需要进行一些基本配置才能发挥插件的作用。打开Settings → Other Settings → Save Actions，你会看到几个关键配置区域。
3.1 激活保存操作
首先勾选这两个核心选项：
- Activate save actions on save：保存文件时自动执行配置的操作
- Activate save actions on shortcut：使用快捷键保存时也执行操作
我建议两个都勾选，这样无论你是点击保存按钮还是按Ctrl+S，都能触发自动格式化。
3.2 格式化操作设置
在Formatting Actions区域，这些选项最实用：
- Optimize imports：自动优化import语句，移除未使用的导入
- Reformat file：重新格式化整个文件
- Reformat only changed code：仅格式化修改过的代码
我的经验是同时勾选前两项。第三项适合大型文件，可以加快保存速度，但可能会造成格式不统一。
4. 高级配置：打造个性化工作流
4.1 自动补全代码结构
在Java Inspection and Quick Fix区域，有几个非常实用的选项：
- Add missing @Override annotations：自动添加遗漏的@Override注解
- Add blocks to if/while/for statements：为控制语句自动添加大括号
我曾经在一个项目中启用了这两个选项，结果发现代码规范性大幅提升。特别是自动添加大括号的功能，避免了很多潜在的逻辑错误。
4.2 文件类型过滤
如果你只想对特定类型的文件启用自动格式化，可以在File Path Inclusion Patterns中添加过滤规则。例如：
*.java, *.kt, *.xml这样插件就只会处理Java、Kotlin和XML文件，不会影响其他类型的文件。
4.3 排除特定目录
有些自动生成的代码目录（如target、build）可能不需要格式化，可以在File Path Exclusion Patterns中排除：
**/target/**, **/build/**5. 实际应用中的技巧与避坑指南
5.1 与团队规范保持一致
在使用Save Actions前，建议先和团队统一代码风格配置。可以在项目根目录下添加.editorconfig文件，定义统一的缩进、换行等规则。这样无论团队成员使用什么编辑器，都能保持代码风格一致。
5.2 处理多模块项目
对于大型多模块项目，我建议在每个模块都配置相同的Save Actions设置。可以在IDEA的Settings for New Projects中预先配置好，这样新建模块时会自动继承这些设置。
5.3 性能优化技巧
如果项目很大，保存时感觉卡顿，可以尝试：
- 勾选"Reformat only changed code"而不是全文件格式化
- 排除不需要格式化的目录
- 关闭一些不必要的检查项
5.4 常见问题解决
问题1：保存时没有触发自动格式化
- 检查插件是否已启用
- 确认文件类型在包含规则中
- 查看IDEA事件日志是否有报错
问题2：自动导入的类不是想要的
- 这种情况通常是因为有多个同名的类
- 可以在设置中调整导入优先级
- 或者暂时禁用自动导入功能
6. 与其他插件的协同工作
Save Actions虽然强大，但与其他插件配合使用效果更佳。我常用的组合是：
6.1 与Checkstyle配合
Checkstyle负责静态代码检查，Save Actions负责自动修复。可以在保存时先运行Save Actions格式化代码，再运行Checkstyle检查剩余问题。
6.2 与SonarLint集成
SonarLint能发现更复杂的代码质量问题，而Save Actions处理基础的格式问题。两者结合可以覆盖从代码风格到代码质量的各个方面。
6.3 与Git配合
建议在提交代码前先保存一次，让Save Actions完成最后的格式化。这样可以避免在代码审查时因为格式问题被打回。可以在.git/hooks/pre-commit中添加保存命令，实现自动化。
7. 从个人使用到团队推广
最初我只是个人使用Save Actions，后来发现它对团队效率提升更大。我们团队现在的新人入职流程中，就包含了配置Save Actions的步骤。具体实施方法：
- 创建团队统一的代码风格配置文件
- 编写Save Actions的推荐配置文档
- 在项目README中添加配置说明
- 定期检查团队成员配置情况
这样做之后，我们的代码审查中关于格式的讨论减少了80%以上，团队可以更专注于业务逻辑的实现。