IDEA 设置类和方法注释模版

1定义java文件头部的注释

2给java类中的方法添加上注释

      2.1第一步勾选Enable Live  Templates

      2.2第二步新建一个Group

      2.3第三步新建一个Template

      2.4第四步点击Define按钮

      2.5第五步填写注释模板

 

1、定义java文件头部的注释

打开设置面板,然后填写注释模板:

File  => setting  => editor =>  File and Code Templates

如图:

 

 

2、给java类中的方法添加上注释

2.1、第一步勾选Enable  Live  Templates

首先要在上一章节的图中勾选中 Enable  Live  Templates

如图:

2.2、第二步新建一个Group

其次要打开LiveTemplates 然后新建一个Group

如图:

     

 

在弹窗口中输入你想要的group名称,例如我取名叫chenjieGroup

如图:

 

点击OK,你已经新建了一个模板组,名称叫chenjieGroup

如图:

 

 

 

2.3、第三步新建一个Template

       选中新建的group,也就是选中chenjieGroup,在这个group下新建一个LiveTemplate

如图:

 

 

       上图中点击Live Template之后,将会新建一个模板,并且光标定位到了需要你输入快捷键的方框中

 如图:

 

        我输入了cjm意思是当我在java文件的某个方法内部,连续输入cjm后,intellij将会在该方法的头上为我自动生成注释(根据我接下来定义的模板来生成)。

 

2.4、第四步点击Define按钮

         点击上图中的Ok按钮左上方的define

  如图:

 

 

       在弹出的下拉框内选择作用域,这里选择java文件

   如图:

  

 

2.5、第五步填写注释模板

 在第四步完成后,Templatetext框内的内容可以编辑了,在Template text 内写入模板,例如我敲入的模板是:

/**

 *@描述 

 *@参数  $params$

 *@返回值  $return$

 *@创建人  chenjie

 *@创建时间  $date$

 *@修改人和其它信息

 */

如图:

 

     说明:在此步骤中,模板内容你可以自己写,两个$号内部是参数名称,都有哪些参数呢,你可以点击Editvariables,然后在弹窗口中自己查看和选择

   点击Edit variables会弹出框

如图:

   

 

弹出框

如图:

   

 

 

   上图中,Name这一列是你可以设置的参数名称,Expression这一列是你可以选择的表达式,点击Expression这一列的单元格,即可出现下拉框

   如图:

  

 

例如我依次给params、return、date这三个变量设置了表达式

如图:

 

点击OK(两个窗口上的OK都要点击)

 

好了,现在可以验证了。

新建一个Utils类

如图:

  

取名Utils

如图:

 

  

可以看到,文件头部的注释已经有了

如图:

 

   

新建一个方法,内容如下:

 public static String sayHello(String userName)
{
     return "hello "+userName; 
}

 

如图:

  

在上图画红框的地方输入我们刚才设置的快捷键cmj即可看到intellij给我们添加的注释

如图:

   

 

快捷键需要在方法内部,也就是花括号内部,至于是不是在红框的位置都可以,例如在return语句的后面或者其他地方也可以,只要是在sayHello方法内部即可。我输入cjm然后就可以得到提示

如图:

 

 

好了,敲回车后,intellij将我输入的cjm替换为了方法的注释(根据我们上一步设置的模板来生成注释)

 如图:

 

       说明:此时有点2,还需要自己把注释剪切到方法外部去,不过总比我们手动敲注释好多了。快捷键可以在方法外部敲,也可以生成注释,但是参数和返回值就没法给你生成了,因为参数和返回的值只有在函数作用域内,intellij才能找到,所以快捷键最好还是在方法内部敲,我刚才的cjm就是在方法内部敲的。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: 在IDEA编程软件中,设置方法注释模板是非常方便的。在设置之前,我们首先要了解方法注释的格式。一般情况下,方法注释包括以下内容:方法的功能描述、参数说明、返回值说明、异常抛出说明。下面是一个典型的方法注释格式: /** * 方法描述: * @param 参数名 参数说明 * @return 返回值说明 * @throws 异常类型 异常说明 */ 接下来,我们可以通过以下步骤来设置方法注释模板: 1.打开IDEA编程软件,点击文件菜单栏中的Settings选项; 2.在Settings窗口中,点击Editor -> Code Style -> Java选项,打开Java代码风格设置页面; 3.在Java代码风格设置页面中,点击JavaDoc选项卡,找到Method和Constructor选项,可进行对方法和构造函数注释模板的设置; 4.在设置注释模板之前,我们可以先查看一下注释模板是否已经存在,在JavaDoc选项卡中,可以看到已有的模板列表; 5.若模板不存在,我们可以点击"+"按钮,添加注释模板。在注释模板中输入常用的方法注释格式,注意要使用变量,例如${NAME}、${PARAM}等; 6.点击OK按钮保存设置,即可在写代码时使用该注释模板。 通过以上步骤,我们可以在IDEA中方便地设置方法注释模板,从而提高我们的编码效率和代码质量。 ### 回答2: Idea是一款常见的Java开发编辑器,在实际的开发过程中经常需要添加注释,以便后续代码的可读性和易维护性。在Idea中,我们可以针对不同的注释类型设置模板,这些模板可以帮助我们快速生成注释。 首先,在Idea中打开“Settings”(或者“Preferences”,具体视操作系统而定),在左侧导航栏中选择“Editor”,然后在右侧面板中选择“File and Code Templates”。 在“File and Code Templates”面板中,我们可以看到Idea中支持的各种代码文件类型,包括Java Class、Java Interface、JUnit Test等等。针对每个类型,我们可以自定义模板,在模板中指定注释生成的格式以及需要生成的内容。 具体来说,我们可以在模板中引用变量,这些变量会自动替换成真实的信息。比如,在Java Class文件中,我们需要生成类名、作者、创建时间等信息,我们就可以在模板中对应添加以下代码: ``` #set($USER = "Your Name") /** * Description: * Created by $USER on ${DATE}. */ ``` 其中,$USER、${DATE}等都是Idea中预定义好的变量,分别表示当前用户和当前日期。在使用模板的时候,这些变量会自动被替换为真实的值。 除了引用变量,我们还可以使用语句控制注释生成的内容。例如,在Java Method中,我们可能需要生成参数注释,我们可以使用以下模板: ``` /** * Description: * * @param ${PARAMETER_NAME} ${OPTIONAL_DESCRIPTION} * @return ${TYPE} */ ``` 在生成注释时,Idea会自动遍历方法参数,为每一个参数生成注释。 总的来说,Idea自定义注释模板的方法非常灵活,可以根据具体的需要来定制。通过合理的注释设置,可以提高代码的可维护性和可读性,提高开发效率。 ### 回答3: 在IDEA中,我们可以通过设置方法注释模板来快速生成注释,提高代码的可读性和可维护性。下面介绍具体的设置方法。 1. 打开IDEA界面,并进入“Settings”。 2. 在“Settings”中,找到“Editor”->“File and Code Tempates”选项。 3. 点击“File and Code Tempates”中的“Include”选项,并选择“Java Class”或“Java Method”等需要设置注释模板的文件类型。 4. 在选择的文件类型下,点击“Edit”按钮,打开文件模板编辑窗口。 5. 在编辑窗口中,找到“Comments”标签页,并选择“Method”或“File Header”。 6. 在“Method”或“File Header”下的文本框中,输入需要设置注释模板,例如: /** * ${DESCRIPTION} * @param ${PARAMETER} * @return ${RETURN} * @author ${USER} * @since ${DATE} */ 或者: /** * ${DESCRIPTION} * @author ${USER} * @version ${DATE} */ 7. 将${DESCRIPTION}、${PARAMETER}、${RETURN}、${USER}、${DATE}等占位符进行替换,并根据需要进行修改。 8. 点击“OK”按钮,保存设置。 9. 在新建方法或类等需要添加注释的地方,通过“Ctrl+Shift+Enter”或“Cmd+Option+T”快捷键,快速生成注释。 通过上述步骤,我们可以轻松设置IDEA中的方法注释模板,并且在编写代码过程中快速生成规范的注释,提高代码质量并减少重复工作。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值