AndroidStudio：格式化注释

AndroidStudio：格式化注释

1、格式化缩进

①Settings > Editor > Code Style > Java > Wrapping and Braces；格式化注释缩进对齐

②Settings > Editor > Code Style > Java > JavaDoc；不格式化注释

2、注释起始空白被迫缩进一团

/**
     *                              结果
     *                            /
     *                          yes
     *                         /
     *                 条件B
     *               /         \
     *             no           no
     *           /               \
     *      条件A                 结果
     *           \
     *            yes               结果
     *        ⁠⁠⁠⁠⁠      \              /
     *               \          yes
     *                \        /
     *                 条件C               结果
     *                        \             /
     *                         no         yes
     *                          \        /
     *                           条件D                结果
     *                                   \             /
     *                                    no         yes
     *                                     \        /
     *                                      条件E
     *                                              \
     *                                               no
     *                                                \
     *                                                 结果
     */

格式化会自动将前面全部是空格字符的注释缩进，缩成一团：

/**
     * 结果
     * /
     * yes
     * /
     * 条件B
     * /         \
     * no           no
     * /               \
     * 条件A                 结果
     * \
     * yes               结果
     * ⁠⁠⁠⁠⁠      \              /
     * \          yes
     * \        /
     * 条件C               结果
     * \             /
     * no         yes
     * \        /
     * 条件D                结果
     * \             /
     * no         yes
     * \        /
     * 条件E
     * \
     * no
     * \
     * 结果
     */

可以使用任意非空白字符在开始占位，比如<p>

/**
     * <p>                             结果
     * <p>                           /
     * <p>                         yes
     * <p>                        /
     * <p>                条件B
     * <p>              /         \
     * <p>            no           no
     * <p>          /               \
     * <p>     条件A                 结果
     * <p>          \
     * <p>           yes               结果
     * <p>       ⁠⁠⁠⁠⁠      \              /
     * <p>              \          yes
     * <p>               \        /
     * <p>                条件C               结果
     * <p>                       \             /
     * <p>                        no         yes
     * <p>                         \        /
     * <p>                          条件D                结果
     * <p>                                  \             /
     * <p>                                   no         yes
     * <p>                                    \        /
     * <p>                                     条件E
     * <p>                                             \
     * <p>                                              no
     * <p>                                               \
     * <p>                                                结果
     */

参考资料：

        android studio 格式化代码时不格式化注释

        解决格式化时，注释部分没有缩进的问题