Java类内划分功能区块的注释规范是什么？是否支持IntelliJ折叠？

Java没有官方定义的类内功能区块划分注释规范，但有两种常用方案可以满足你的需求，且都可以适配IntelliJ IDEA的折叠功能：

1. IDEA原生支持的可折叠区块标记 #

IDEA原生支持//region + //endregion的标记对，不需要额外配置就能直接识别并提供折叠能力，还支持自定义区块名称，可读性极强，是Java开发中最常用的同类方案。
示例代码如下：

public class DataStream {
    //region 读流功能模块
    public void read() {
        // 逻辑实现
    }

    public void decode() {
        // 逻辑实现
    }
    //endregion

    //region 流解析功能模块
    public void extractData() {
        // 逻辑实现
    }

    public void mapDataTypes() {
        // 逻辑实现
    }
    //endregion

    //region 数据分析功能模块
    public void aggregatedData() {
        // 逻辑实现
    }

    public void deduceInsights() {
        // 逻辑实现
    }
    //endregion
}

使用这个方案的优势是开箱即用，IDEA会自动在标记对应行左侧显示折叠箭头，也支持通过快捷键批量操作区块的折叠/展开状态，团队协作时也没有额外的理解成本。

2. 通用分割注释（不绑定IDE） #

如果你希望注释格式不绑定特定IDE，可以使用行业内通用的分割线注释方案，写法如下：

public class DataStream {
    /* -------------------------- 读流功能模块 -------------------------- */
    public void read() {
        // 逻辑实现
    }

    public void decode() {
        // 逻辑实现
    }

    /* -------------------------- 流解析功能模块 -------------------------- */
    public void extractData() {
        // 逻辑实现
    }

    public void mapDataTypes() {
        // 逻辑实现
    }
}

这种格式在任意编辑器下都能实现区块分割的视觉效果，如果你需要IDEA支持折叠，可以在设置的「编辑器>常规>代码折叠」路径下添加自定义折叠规则，匹配这类分割注释即可实现折叠能力。

注：这类注释划分仅适用于确实无法拆分为多个独立类的场景，常规情况优先使用组合、内部类、接口拆分等面向对象方式解耦，会比注释划分的可维护性更高。

内容的提问来源于stack exchange，提问作者Liran Funaro