JetBrains IDE 怎样配置保存时自动检查

JetBrains IDE 的“保存时自动检查”主要在 Tools → Actions on Save 中配置。进入后可以按项目选择 Reformat code、Optimize imports、Run code cleanup 等动作；保存文件时，IDE 会按当前勾选项执行。若你发现保存后没有变化，先分清是文件根本没有保存，还是保存动作已发生但没有配置任何 Actions on Save。

官方地址：https://www.jetbrains.com/help/idea/saving-and-reverting-changes.html

下面以 JetBrains 系列 IDE 的通用设置名称说明。不同产品或版本的菜单位置可能有细微差异，但排查顺序相同：先确认保存触发条件，再确认保存动作，最后确认插件、范围和可见结果。文中的界面图是原创操作说明图，不是真实软件截图。

1. 先区分自动保存和保存时动作

IDE 自动保存文件并不等于已经启用了格式化或检查。官方说明中，编译、运行、调试、版本控制操作、关闭文件或退出 IDE 等事件都可能触发保存；另外也可以在系统设置中增加“切换到其他应用时保存”和“空闲 N 秒后保存”。这些选项只回答“文件何时写入”，而 Actions on Save 回答“写入时还要执行什么动作”。

因此，遇到“保存时自动检查不生效”，先做一个最小判断：用 Ctrl+S 或 File → Save All 主动保存同一个文件。如果文件内容被重新排版、未使用导入被整理，说明保存动作已经接通；如果文件只是保存了但内容没有变化，再进入下一步查看动作勾选项。

2. 打开当前项目的 Actions on Save

按 Ctrl+Alt+S 打开 Settings。在左侧依次进入 Tools → Actions on Save。这个页面用于当前项目；如果要给以后新建的项目设置默认值，应从 File → New Projects Setup → Settings for New Projects → Tools → Actions on Save 进入。

进入页面后，先确认顶部显示的是当前项目设置，而不是新项目默认设置。这样可以避免“我明明勾选了，但当前项目仍没有动作”的错觉。若项目使用了共享设置或团队约定，也要先确认当前配置没有被项目级文件覆盖。

3. 选择真正需要的保存动作

Actions on Save 中的动作可以按需求组合，但不建议一开始全部打开。常见选择如下：

第一次配置时，建议先只勾选 Reformat code 或 Optimize imports 中的一个，保存后观察改动，再逐个加入其他动作。对于 Run code cleanup，要先确认选择的检查配置确实包含希望应用的修复；否则动作可能执行了，但文件看起来没有变化。

某些动作旁边会出现配置链接。以 Reformat code 为例，可以进入 Configure scope，排除特定文件夹，或选择只处理修改行而不是整个文件。保存动作的“开关”与动作的“处理范围”是两层配置，不能只看复选框判断最终改动范围。

4. 应用设置，再用 Ctrl+S 看可见结果

点击 Apply，再关闭 Settings。打开一个格式明显不规范、或包含可整理导入的演示文件，做一处小改动后按 Ctrl+S。也可以选择 File → Save All，两种方式都属于显式保存。

确认时不要只看文件标签是否消失了修改标记。还要看与所选动作对应的结果：

• 勾选 Reformat code：代码缩进、空格和换行符合当前代码样式。
• 勾选 Optimize imports：导入顺序发生预期整理，未使用导入被处理。
• 勾选 Run code cleanup：只有检查配置中可自动修复的问题被处理。
• 勾选 Prettier 或 eslint --fix：项目配置允许时，文件出现对应的格式或修复结果。

这些结果是读者本机的可见确认条件，不应把界面中的示意状态当成已经在当前项目运行过的证据。若按 Ctrl+S 后没有变化，继续检查下面的依赖和作用范围，而不是先反复切换保存方式。

5. 动作不生效时按依赖和范围排查

动作选项不存在：先确认打开的是正确的 JetBrains IDE 和当前项目设置。一些动作来自内置能力，另一些动作由插件或项目工具提供；例如 Prettier、ESLint 的保存动作需要相应的插件和项目配置支持。

选项存在但没有改动：检查动作右侧的配置链接和作用域。文件可能被排除，或者当前文件类型不属于动作处理范围。Run code cleanup 还要检查 Project Profile，配置为空或没有可应用的修复时，保存后没有可见变化是正常的。

手动保存有效，切换应用无效：这通常说明 Actions on Save 已配置，但自动保存触发条件没有按预期发生。回到 Appearance & Behavior → System Settings，查看保存外部变化相关的选项，再用一次明确的 Ctrl+S 复现，避免把两类问题混为一谈。

改动范围过大：先取消 Rearrange code 或 Run code cleanup，只保留一个动作；也可以在动作的 Configure scope 中缩小范围。对团队项目，保存前最好先查看差异，避免个人 Code Style 与仓库规则不一致时产生大量无关改动。

6. 需要时回退保存动作

如果保存时的自动修改不符合项目约定，回到 Tools → Actions on Save 取消对应复选框并点击 Apply。不要为了关闭一个动作清空整个 IDE 设置。对于刚刚保存产生的最近改动，可以用 Ctrl+Z 撤销；需要查看更详细的历史时使用 Local History，但它不能替代版本控制和备份。

一个稳妥的配置顺序是：先开启一个动作，保存一个小文件，查看差异；确认结果符合预期后，再加入第二个动作。这样每次改动都有明确来源，也方便在格式化、导入优化和代码清理之间定位问题。

常见问题

保存时自动检查和自动保存是同一项设置吗？

不是。自动保存控制文件什么时候写入，Actions on Save 控制保存时附带执行哪些动作。两者都配置后才会形成“自动保存并自动整理”的效果。

为什么配置了 Actions on Save，按 Ctrl+S 仍然没有变化？

先确认动作复选框、文件作用域、Code Style 或 Project Profile，再检查动作需要的插件和项目配置。没有可见改动不一定表示保存失败，也可能是当前文件已经符合规则。

能不能同时开启格式化、导入优化和代码清理？

可以，但应按项目规则逐项启用并查看差异。它们的改写范围不同，尤其是 Rearrange code 和 Run code cleanup，建议先在小范围文件上确认结果。

参考地址：https://www.jetbrains.com/help/idea/saving-and-reverting-changes.html