开发工具IDEA——增加注释快捷按键和jsdoc使用手册
安装和jsdoc使用手册
http://www.wuweigang.com/?id=302
开发工具IDEA——增加注释快捷按键
简介
开发工具IDEA系列文章是我在进行Java开发时使用IDEA开发工具一些设置和其调整,特将其整理出来分享给大家,特别适合于刚接触开发或者刚重新安装开发工具的小伙伴们,可以根据这一系列文章将IDEA工具调校成为自己的左膀右臂,助力自己的Java开发。
环境
- 系统:windows10
- 开发工具:IDEA
- 语言:Java
内容
之前我进行设置了开发工具IDEA——创建类或方法注释,但是有时我们的类文件或者方法已经存在了,我只是想补充一下注释,这时我们就需要使用到快捷键进行注释了,对此,我们需要配置一个符合于我们自己注释格式的快捷键,下面我们就开始进行配置。
1、打开IDEA进入File——Setting——Editor——Live Templates
点击右侧的+号,选择Template Group模板分组添加
![](https://ask.qcloudimg.com/http-save/yehe-1220865/82df4c424daa2483fb305037bdb1f3d8.png?imageView2/2/w/1620)
image-20210916141039204
![](https://ask.qcloudimg.com/http-save/yehe-1220865/9c40791ee93b8f5489071085d3eb4c4a.png?imageView2/2/w/1620)
image-20210916141155600
2、选择刚添加的分组,再次点击右侧的+号,选择Live Template进行添加一个代码模板,并添加基础信息
![](https://ask.qcloudimg.com/http-save/yehe-1220865/4ed9d05371051244caf75bf07437fc04.png?imageView2/2/w/1620)
image-20210916141832775
其中Template text使用的代码如下,可根据自己的需求进行灵活调整。
**
* <p> </p>
* @date $data$ $time$
$params$
* @return $return$
* @throws $throws$
* @version 1.0
* @author $user$
*/
3、点击Edit variables 进行设置刚才在Template text中使用的一些变量对应的值或方法。
![](https://ask.qcloudimg.com/http-save/yehe-1220865/7eba5934d3406ae02e74a9660b1357a8.png?imageView2/2/w/1620)
image-20210916142041932
![](https://ask.qcloudimg.com/http-save/yehe-1220865/c718d809983596c07375bd99e5f92dd5.png?imageView2/2/w/1620)
image-20210916142558400
其中params使用的是如下自定义方法:
groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+=' * @param ' + params[i] + ((i < params.size() - 1) ? '\\n' : '')}; return result", methodParameters())
4、进行设置触发方式为回车Enter
![](https://ask.qcloudimg.com/http-save/yehe-1220865/63a6f2d9b96ae3235b1c50edc6791c71.png?imageView2/2/w/1620)
image-20210916142908275
5、进行设置生效的范围
![](https://ask.qcloudimg.com/http-save/yehe-1220865/9604e4672ad956a1b6ae738b52af9672.png?imageView2/2/w/1620)
image-20210916142955786
![](https://ask.qcloudimg.com/http-save/yehe-1220865/f47d853e34b9d08888ee1b96b22387f5.png?imageView2/2/w/1620)
image-20210916143003002
到达这里,我们就可以在方法上方进行实现输入/***然后按下回车键实现注释根据方法进行生成了。
下面我再次分享一下我设置的用于方法快捷键和用于类注释快捷键的模板内容
方法函数
**
* <p> </p>
* @date $data$ $time$
$params$
* @return $return$
* @throws $throws$
* @version 1.0
* @author $user$
*/
![](https://ask.qcloudimg.com/http-save/yehe-1220865/204c9bad0c647b701f2625ac0ba625fe.png?imageView2/2/w/1620)
image-20210916143430667
groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+=' * @param ' + params[i] + ((i < params.size() - 1) ? '\\n' : '')}; return result", methodParameters())
类头部
**
* 类 {@code $NAME$} 补充名称 <br> 补充简述.
*
* Copyright (c) 版权所有 <a href="https://blog.cnhuashao.com">CN華少</a><br>
* @since v1.0.0
* @version v1.0.1 $data$ $time$
* @author <a href="mailto:lz2392504@gmail.com">$user$</a>
* @see 相关联的类,每个类或方法单独一个@see标签
* @TODO 代办事项的标记
*/
![](https://ask.qcloudimg.com/http-save/yehe-1220865/aab057be8fb509007d7b37c2b1280a68.png?imageView2/2/w/1620)
image-20210916143652483