[转]Intellij Idea自动添加注释的方法

Intellij Idea自动添加注释的方法

 

阿历Ali 关注

2017.08.20 21:22* 字数 914 阅读 2741评论 0喜欢 6

程序媛阿历终于要写第一篇关于开发的文章了！！！

阿历用Intellij Idea开发，版本是Ultimate 2017.2.2。这周写代码的时候，发现编辑注释很麻烦，不但要写注释符，还要写名字、日期、描述等等，很繁琐。工具是用来提升效率的，为了提升开发的效率，我去网上搜索了Intellij Idea自动添加注释的方法。由于现有总结不够全面，并且有的方法对于个人版本不太奏效，因而我整理了自动添加注释的方法（很抱歉忘记记录参考的网址了），亲测有效。

自动添加注释有两类方法：一、建立文件时，idea自动生成注释；二、在编辑源文件时，插入注释。下面具体介绍。

一、建立文件时，idea自动生成注释

第一种很简单，一张图就能够说清楚。过程是，在设置中找到“File and Code Templates”，在类文件的模板中添加注释。具体以下图（图1）所示：

（1）首先打开设置，点File，Settings便可打开下图界面，或者直接用快捷键“Ctrl+Alt+S”（我特别喜欢用快捷键^^）打开设计界面。

（2）在搜索框中输入“File and Code Templates”，打开“File and Code Templates”。

（3）在右侧的Files一栏中，找到Class，编辑注释。下面的Description介绍了可使用的系统变量，按需索取。

（4）最后点击Apply和OK就完成啦。

 

图1 新建文件，自动生成注释

至此，你能够新建一个class文件，测试一下啦！

二、在编辑源文件时，插入注释

这个步骤有点多，可是一样很简单。大体过程是打开“Live Templates”，新建咱们本身的template，编辑注释文本，定义应用文件，编辑变量。具体看下面：

（1）打开Settings，找到“Live Templates”，点右侧“+”，新建一个“Template Group...”，见图2.一、2.2。

 

图2.1 新建Template Group

 

图2.2 输入Group名字

（2）选中刚建好的Group，再点右侧“+”，建立一个“Live Template”，见图2.3。

 

图2.3 新建Live Template

（3）编辑Template的缩写（插入注释时用），在Template text中编辑注释模板（如图2.4）。注意变量的定义方式，用两个$包围变量名，例如变量user的定义为$user$。

（4）定义应用这个Template的环境，点击Define。我选择了Java（如图2.5）。

 

图2.4 编辑注释

 

图2.5 选择应用场景

（5）编辑变量，点击“Edit variables”，如图2.六、2.7。给变量选择表达式或者定义默认值。

 

图2.6 编辑变量

 

图2.7 选择表达式或设置默认值

（6）最后点击“Apply”和“OK”（图），就完成啦。

 

图2.8 完成设置

试试这个方法吧（图2.九、2.10）：在class源文件编辑器中，输入步骤（3）设置的模板缩写，例如我设置的是“cmmt”。Idea会显示提示，而后回车，就插入注释了。

 

图2.9 测试

 

图2.10 效果

 

结语：

成功设置了自动添加注释，感受仍是很神奇的，佩服开发工具的工程师。

虽然研究设置花费必定的时间，可是成功以后用得就很爽了，简直是一劳永逸！

之后会尽可能多写跟技术相关的文章~~毕竟是个程序媛，哈哈。加油！

但愿本文对你有帮助。