这两天发现了一个很好用的javadoc 以及方法名称定义的一个插件, 源码作者是在19年开始研发的,到现在21年的最新版本,此处是作者的项目地址:

https://gitee.com/starcwang/easy_javadoc

主要功能如下:

支持的IDEA版本为 2018.1 及以上

idrac java插件 idea javadoc插件_快捷键

支持给中文起名字,类似程序员起名神器

idrac java插件 idea javadoc插件_intellij-idea_02

接入有道、百度、腾讯等翻译,只要你方法名起的好,翻译就越准确
可自定义映射,弥补自动翻译的不足
支持文档翻译,选中需要翻译的文档,使用快捷键翻译注释,再也不用在词典和IDEA之间来回切换了

安装
打开IntelliJ IDEA -> plugin,搜索 Easy Javadoc,安装重启即可

配置

打开配置页面 配置图 可看到相关配置

idrac java插件 idea javadoc插件_idrac java插件_03

使用
将光标放置到想要生成注释的类、方法或者属性上,然后按下快捷键ctrl \或者command \,即可生成注释,你的方法名起的越贴切,注释越得体。
将光标放置到想要生成注释的类上,然后按下快捷键ctrl shift \或者command shift \,即可批量生成文档注释。
光标选中要翻译的中文,然后按下快捷键ctrl \或者command \,即可自动变成英文,类似程序员起名神器。
光标选中要翻译的非中文,然后按下快捷键ctrl \或者command \,即弹出选中的翻译结果,再也不用在词典和IDEA之间来回切换了。
单行注释需要打开如下开关 单行注释
方法的@return注释样例
code模式

@return {@code User}
@return {@code Map<String, Integer>}
link模式
@return {@link User}
@return {@link Map}<{@link String}, {@link Integer}>

当然,翻译不准的情况很常见,如果是因为单词翻译错误,可以在配置页面对自己的单词进行配置,自定义翻译的优先级大于其他。

腾讯和百度翻译都可以免费使用,需要自己申请相关APP_ID

百度翻译申请地址:https://api.fanyi.baidu.com/doc/21
腾讯翻译申请地址:https://cloud.tencent.com/document/product/551/7372
默认快捷键(可通过IDEA快捷键设置修改)

win
快捷键 作用域 说明
ctrl \ 类、方法、属性(光标放上面就行,不要双击选中!) 生成当前文档注释
ctrl \ 选中的中文 生成选中的中文的英文命名
ctrl \ 选中的非中文 弹框展示翻译结果
ctrl shift \ 类 生成全部文档注释
mac
快捷键 作用域 说明
command \ 类、方法、属性(光标放上面就行,不要双击选中!) 生成当前文档注释
command \ 选中的中文 生成选中的中文的英文命名
command \ 选中的非中文 弹框展示翻译结果
command shift \ 类 生成全部文档注释