idea 自定义 javadoc

目录

1.idea版本

 2.配置class javadoc

 3.配置method javadoc

---

1.idea版本

macos : 

idea : 

 2.配置class javadoc

参考配置：

#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end
/**
 * @author ${USER}
 * @time ${YEAR}-${MONTH}-${DAY} ${HOUR}:${MINUTE}:${SECOND}
 * @description TODO
 */
public class ${NAME} {
}

效果参考（创建文件后，自动添加如下javadoc）：

package com.sun.demo.web.pojo;

/**
 * @author sun
 * @time 2022-09-14 14:43:35
 * @description TODO
 */
public class DemoPojo {
}

 3.配置method javadoc

注：其他博客中，都建议通过Live Templates自定义method javadoc，思路是创建自定义template，然后配置注释格式，然后配置触发快捷键，博主曾经使用过，感觉不如直接修改idea默认的method javadoc的格式。

如图配置idea 默认的 method javadoc 模板，即可在添加方法javadoc的时候，直接触发。

参考配置（只是在默认的格式上加了author，第一行是自定义加的，其他的都是默认的）： 

 * @author ${USER}
#foreach($param in $PARAMS)
 * @param $param
#end
#if($RETURN_TYPE != "void")
 * @return
#end
#foreach($param in $TYPE_PARAMS)
 * @param <$param>
#end
#foreach($exception in $THROWS)
 * @throws $exception
#end

参考效果（通过默认的快捷键组合【/**+Enter】触发）：

    /**
     * 
     * @author sun
     * @param var1
     * @param var2
     * @param var3
     * @return
     * @throws Exception
     */
    public String test(String var1, String var2, int var3) throws Exception {
        
        return "test";
    }

参考：

Javadocs | IntelliJ IDEA