IntelliJ IDEA 日文注释对齐问题完整排查记录

问题现象#

在编写 Java 文件时，文件头部常见的日文注释（变更履历）在さくらエディタ (Sakura Editor) 里对得整整齐齐：

1
/* 変更履歴
2
 * □□変更日□□□変更者□□□□変更概要
3
 * □□202X/0X/XX □□XXXX □□新規作成
4
 */

但一打开 IntelliJ IDEA，立刻错位得惨不忍睹：

• *、□、日期、日文字符混在一起，第二行、第三行完全歪掉。
• 即使把主字体直接改成 MS Gothic（大小 15.0），重启 IDEA 后依然不对齐。

这是日文/中文开发者在 IDEA 里最常见的坑：全角字符宽度在不同渲染模式下不是严格的 2 倍半角，导致多行累积误差。

第一阶段：切换主字体为 MS Gothic（失败）#

尝试设置：

Settings → Editor → Font

• Font: MS Gothic
• Size: 15.0
• Line height: 1.2
• Fallback font: <None>

结果： 重启后仍然错位。

原因分析： MS Gothic 在 Subpixel 渲染下，全角实际宽度仍有微小浮动（1.98~2.02 倍），这种像素级的微调在长字符串下会导致严重的累积偏差。

第二阶段：发现 Antialiasing 设置（关键突破）#

设置位置：

Settings → Appearance & Behavior → Appearance → Antialiasing

• IDE: Subpixel（保持）
• Editor: Subpixel（默认） → 改为 Greyscale → Apply → 重启 IDEA

结果： 注释瞬间对齐，效果与 Sakura Editor 一致！

原理： Subpixel（次像素渲染）为了文字圆润会微调间距，对 CJK（中日韩）字符宽度有负面影响；Greyscale（灰度渲染）渲染更保守，强制像素级对齐。

第三阶段：换 Sarasa Mono（终极方案）#

虽然 Greyscale 解决了对齐，但英文看起来会略显模糊。为了兼顾“对齐”与“美观”，我们引入了更纱黑体 (Sarasa Gothic)。

1. 下载 Sarasa Mono：GitHub Releases （建议选 TTF 版本）。
2. 更新设置：
   • Font: Sarasa Mono SC (或 Sarasa Mono J)
   • Size: 15.0（或 14.0，视屏幕分辨率而定）
   • Line height: 1.2
3. 还原渲染设置：将 Editor Antialiasing 改回 Subpixel。

结果：

• 日文注释完美对齐：Sarasa 系列字体在设计上保证了全角严格等于 1:2 的半角宽度。
• 英文锐利好看：利用 Subpixel 提升了代码阅读的清晰度。
• 稳定性：跨平台显示一致。

最终推荐配置#

总结#

解决 IDEA CJK 对齐问题的三步走：

1. 测试：将 Editor Antialiasing 改为 Greyscale 确认是否为渲染引起。
2. 根治：安装 Sarasa Mono，从字体层面强制 1:2 比例。
3. 优化：切回 Subpixel 保证英文字符的视觉巅峰。

现在 IDEA 里的变更履历终于不再乱跳，强迫症表示非常舒适！

参考资料：Sarasa Gothic GitHub