1. 先别急着调设置：搞清楚注释时的空格是从哪冒出来的
我最早被这个问题恶心到，是在一次大范围代码重构的时候。方法内部为了分层清晰，逻辑块之间留了不少空行。某天想临时注释掉一整段代码，习惯性Ctrl + /按下去，结果满屏都是//这种行。代码行加注释符还能理解，空行为什么也要老老实实加上//，而且前面还顶着缩进、后面还要跟个空格？当时没多想，直接提交了。代码评审的时候，对方指着 diff 里的空白行问我："这//你是要表达什么？"
我盯着那条 diff，自己也解释不清。更奇怪的是，等我把这段注释再按一次Ctrl + /取消注释时，原来那些空行并没有恢复成"干净的空行"，而是留下了一堆空格和制表符。有些空行前面带着 4 个空格，有些干脆就多了一个空格。那一刻我才意识到，IDEA 的行注释不是简单地在每一行前面加两个斜杠，它背后还偷偷做了很多格式化动作。
要解决这个问题，首先得搞清楚两个空格的来源。第一个来源是空行本身的缩进。当你在一个if块、for块或者类内部按下回车，IDEA 默认会把空行也保留当前层级的缩进，也就是空行里其实有空格。第二个来源是注释符后面的那个空格，IDEA 的代码风格默认会在//和注释内容之间插入一个空格，美其名曰"可读性"。于是当一个空行被注释时，它就成了缩进空格 + // + 空格。如果这段代码在第 3 层缩进里，你看到的就成了//。
这还不算完。真正坑人的是取消注释的行为：IDEA 只会去掉//，并不会帮你清掉缩进和那个多余空格。所以只要你注释过空行，再取消注释，空行里的空格就再也回不去了——除非你单独设置。这就是"空白行注释时不要有空格"这个需求背后的真实痛点：不是空行不能有注释，而是注释产生的空行垃圾让整个文件都显得不干净。
2. 破案的三个设置项：行注释空格背后的控制开关
2.1 注释符后的那个空格：Add a space after line comment
在Settings -> Editor -> Code Style -> Java（或你正在使用的语言）-> Code Generation页面，往下翻能看到一个区域叫Comment Code，里面有两个关键选项：Line comment at first column和Add a space after line comment。
Add a space after line comment控制的就是//后面是否跟着一个空格。勾选时，注释长这样：// 这是注释；不勾选时，变成：//这是注释。
这个设置不是单独针对空行的，而是所有行注释共用的。也就是说，如果你取消它，不仅空行注释变干净了，普通代码的注释也会失去那个空格。很多团队规范（比如 Google Java Style）明确要求//后需要空格，所以这个设置在大多数项目里是默认勾选的。如果你不想影响普通注释的观感，就得另想办法。
2.2 空行要不要带缩进：Keep indents on empty lines
这个选项藏在Settings -> Editor -> Code Style -> Java -> Tabs and Indents页面，名字叫Keep indents on empty lines。
勾选时，空行会保留当前层级的缩进。比如你写了一个if块，里面某一行是空行，那个空行里其实是有空格或制表符的。取消勾选后，空行就是真真正正的一个空字符串，什么缩进都没有。
这个选项对注释的影响很大。如果空行没有缩进，那么当你对空行执行行注释时，IDEA 就不会给空行添加缩进空格，注释符只能从第一列开始。否则，//前面会跟着一串缩进空格，整个空行注释看起来就特别荒唐。所以，想要"空白行注释时不要有空格"，这个选项基本是必关的。
2.3 最后一道兜底：Remove trailing spaces on Save
就算上面两个设置都改了，历史遗留代码里可能还有不少空行带着空格。如果你希望保存文件的时候自动把这些垃圾清掉，可以打开Settings -> Editor -> General -> On Save -> Remove trailing spaces on Save，把选项改成All lines。
这个设置的原理很简单：文件落盘之前，IDEA 会把所有行尾的多余空格（包括空行里的空格）全部删除。它不会影响你打字时的体验，但能保证最终存到磁盘上的文件是干净的。
三个设置项之间的作用范围不同，下面这张表可以帮你快速理解：
| 设置项 | 位置（以 Java 为例） | 控制内容 | 对空行注释的影响 |
|---|---|---|---|
Line comment at first column | Code Style -> Java -> Code Generation | 注释符是顶格还是跟随缩进 | 为true时，空行注释没有缩进空格 |
Add a space after line comment | Code Style -> Java -> Code Generation | //后是否插入一个空格 | 为false时，空行注释不会变成// |
Keep indents on empty lines | Code Style -> Java -> Tabs and Indents | 空行是否保留缩进空格 | 为false时，空行本身没有空格 |
Remove trailing spaces on Save | General -> On Save | 保存前清理行尾多余空格 | 兜底清理空行空格，防止残留 |
3. 实操调校：按你的目标组合配置
3.1 目标一：整体注释风格也变成极简，不接受任何多余空格
如果你完全不能接受空行注释里出现空格，同时也不介意普通代码注释变成//int a = 1;这种紧凑风格，那可以直接按下面这套组合设置：
- 打开
Settings（Windows 是Ctrl + Alt + S，Mac 是Cmd + ,）。 - 左侧依次展开
Editor -> Code Style -> Java。 - 在
Code Generation页面，取消勾选Add a space after line comment。 - 切到
Tabs and Indents页面，取消勾选Keep indents on empty lines。 - 打开
Editor -> General -> On Save，在Remove trailing spaces on Save中选All lines。 - 如果你同时写 Kotlin、Python、Go，记得给每种语言都重复一遍，因为 IDEA 的 Code Style 是分语言保存的，改 Java 不会自动同步到 Python。
改完以后，选中一段包含空行的代码，按Ctrl + /，你会看到空行上只有一个干净的//，普通代码行是//int a = 1;。再按一次取消注释，空行依然是真的空行，没有任何空格残留。
我最初就是这么干的，但用了两天就放弃了。原因很简单：连续看几屏紧凑注释之后，会觉得代码像被压缩过一样，尤其是//TODO、//FIXME这类标识，失去了一个空格之后，视觉上很难快速跳过。而且 Hibernate、JPA 的一些自动生成代码里满是注释，那种被挤压的阅读体验不太舒服。
3.2 目标二：保留//的代码风格，只消灭空行上的多余空格
这个需求才是最普遍的。绝大多数团队规范都要求注释分隔符后有一个空格，所以大家不想全局关掉Add a space after line comment。但空行注释变成//又很碍眼，希望只针对空行去掉那个空格。
遗憾的是，IDEA 目前没有提供"仅空行的注释不加空格"这种精确开关。也就是说，开着Add a space after line comment的情况下，空行注释必然会出现//。你只能借助保存时的清理动作来"事后弥补"。
具体做法：
- 保留
Add a space after line comment（保持勾选）。 - 取消
Keep indents on empty lines，让空行没有缩进空格。 - 保留
Remove trailing spaces on Save为All lines或Modified lines。
这样你在编辑器里刚按下Ctrl + /时，空行上依然是//，但当你保存文件时，IDEA 会把行尾空格去掉，于是落盘的版本变成//。如果你的 IDEA 开启了自动保存，或者你习惯频繁按Ctrl + S，最终效果就等同于"空白行注释时不要有空格"。
要注意：这个过程不是实时的。如果你注释完不保存，空行上的//会一直显示在那里。另外，若你同时使用了.editorconfig或者某些格式化插件，它们可能在格式化时再次给空行注释加上空格，需要额外关注。
3.3 目标三：让普通代码注释顶格，空行注释也顶格
还有一种老派风格是把所有注释都放在第一列，也就是不跟随代码缩进。这种风格在早期 C 语言项目里比较常见，好处是注释区域看起来非常整齐。如果你想要这种效果，只要勾选Line comment at first column即可。
此时，无论是普通代码行还是空行，注释符都从第一列开始。配合取消Add a space after line comment，空行注释就成了第一列的//。代价是整个文件的行注释打破了原有缩进结构，代码可读性其实会下降，因为你要在一堆顶格的注释里找代码块的分层。这个方案我只建议给确实喜欢这种风格的人，不推荐作为一种通用默认配置。
3.4 不同语言、不同版本要注意的细节
我在一个多语言项目里测试过，IDEA 对 Java、Kotlin、Python、Go、JavaScript 都有独立的 Code Style 配置。你改了 Java 的Keep indents on empty lines，不会影响 Python，两者是独立的设置页。如果团队项目里混合多种语言，记得把每个语言都过一遍，或者在设置搜索框里输入indents on empty lines，它会帮你自动定位到相关的语言配置页。
另外，不同 IDEA 版本之间的选项名称和位置可能会有细微差异。比如Add a space after line comment在一些老版本里可能叫Insert space between // and comment text，但搜索关键词line comment基本都能找到。如果你用的是中文界面，注意看选项名里的"注释分隔符"或"行注释"字样，不要和Block comment的设置搞混。
4. 没有完美开关时的替代处理：让空行永远保持干净
4.1 先清空行再注释：最笨但最可靠的办法
如果只是临时注释一段逻辑，你可以在选中代码前，先把空行用Shift + Delete删掉，注释完再按需把空行加回去。这个方法很机械，适合不想动任何设置的场景。但缺点也明显：一旦代码很长，删空行、补空行都会增加大量额外操作，而且容易误删。我只有在改别人留下的代码时偶尔会用，因为不知道对方机器上的 IDEA 设置是什么，贸然改配置可能会影响其他代码风格。
4.2 正则批量清理：只针对已经污染的文件
如果你打开一个历史文件，发现大量空行里带着空格，手动清理太慢了。可以用文件内替换（Ctrl + R），勾选正则表达式，查找^[ \t]+$，替换为空。这会删除所有空白行里的空格和制表符。
注意这个操作是全文件范围的，它会把所有空行里的空格都清掉，包括那些你本来想保留缩进的空行。实际上，如果你已经关闭了Keep indents on empty lines，空行本就不该有缩进，所以用这个正则也没什么问题。但如果团队风格要求空行保留缩进，那就不要轻易用这个方案。
还有一点：IDEA 的正则替换里，^[ \t]+$对 Windows 的\r\n换行符可能需要调整。如果你的文件是 CRLF 行尾，这个正则仍然能匹配到行尾空格，只是你替换后要确认没有破坏换行符。建议在替换前先备份，或者使用预览模式看清楚每一项改动。
4.3 换一种注释方式：用块注释绕开逐行注释
如果你只是临时屏蔽一段包含空行的代码，可以用块注释：选中那段代码后按Ctrl + Shift + /（Windows/Linux）或Cmd + Shift + /（Mac）。IDEA 会在选区首尾插入/*和*/，中间的代码和空行原样保留，不会逐行添加//，自然也不会产生注释空格。
块注释的缺点是不能像行注释那样逐行切换，而且嵌套块注释时很容易出错。比如你注释的代码里本身已经有/* */，再包一层就会出现语法问题。所以这个方法适合短代码段，不适合大段逻辑。
4.4 .editorconfig 团队约定：让所有人都遵循同样的规则
上面的所有设置都是本地 IDEA 层面的，换个环境就失效了。如果团队协作中经常出现"空白行注释带空格"这种 diff 污染，其实更适合用.editorconfig统一规范。
在项目根目录放一个.editorconfig文件，最基本的配置长这样：
root = true [*] charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true [*.java] indent_style = space indent_size = 4其中trim_trailing_whitespace = true对应的就是 IDEA 的保存时清理尾随空格。关键是，.editorconfig支持 IDEA 专用属性，例如：
ij_java_add_space_after_line_comment = false ij_java_keep_indents_on_empty_lines = false加上这两行之后，团队成员只要用 IDEA 打开项目，IDE 会自动读取并覆盖本地 Code Style 配置，所有人都能获得一致的注释行为。不过要注意，ij_开头的属性是 IDEA 专属扩展，其他编辑器（比如 VS Code）不一定认识，所以如果你是跨 IDE 协作，需要维护多份配置，或者接受各自行为的差异。
这个方案的好处是：你不用挨个去指导同事怎么改设置，只要让.editorconfig跟着代码仓库走，大家提交的代码就能自动保持统一。缺点也一样明显：如果你所在的公司里有人强烈坚持//后必须有空格，那ij_java_add_space_after_line_comment = false可能会引发一次小小的"风格战争"。
4.5 提交前查看 diff：最后一道人工防线
无论你调了哪套设置，提交代码前都应该看一眼 Version Control 面板里的 diff。IDEA 会把空行空格显示成浅色的小变更，如果你发现一块区域的改动全是这种"透明变更"，就可以在提交前用正则或手动清理，避免污染 commit 历史。
我自己是这么做的：提交之前先点一下Diff，重点检查有没有空行注释产生的多余空格。虽然麻烦了点，但能有效防止"空行空格"这种问题进入代码评审阶段。时间长了之后，你会形成肌肉记忆，看一眼 diff 就知道哪里不对劲。
5. 我的最终选择：平衡可读性和整洁度
折腾了一圈，我最常用的组合其实是这样的：
Add a space after line comment保持勾选，确保普通注释的可读性不下降。Keep indents on empty lines取消勾选，让空行从一开始就不带缩进。Remove trailing spaces on Save设为All lines，保存时自动清理所有行尾空格。- 项目根目录放
.editorconfig，写入trim_trailing_whitespace = true，让团队其他成员也能受益。
这套配置下，空行注释的即时显示仍然是//，但只要一保存，它就会变成干净的//。我试过为了彻底解决那一个空格而全局关闭Add a space after line comment，后来实在受不了//if (x > 0) {这种紧凑写法。代码注释本来就是为了让人读的，牺牲所有注释的呼吸感去换一个空行的干净，得不偿失。
如果你连"保存后干净"都嫌不够，那我可以再分享一个冷门操作：在 IDEA 里执行Editor -> Remove Trailing Spaces，这个动作会立即清理当前文件所有行尾空格，不需要等待保存。给它绑定一个快捷键，效果几乎等于"一键让空白行彻底干净"。我在纯手工整理历史代码时，偶尔会用到这个功能，效率比正则替换还高。
说到底，"空白行注释时不要有空格"不是一个单一开关能解决的，它涉及缩进策略、注释风格和保存时机三个层面。明白这一点之后，你再遇到类似问题，就不用在设置面板里瞎猜了。
