介绍

本项目是IntelliJ IDEA的插件,能帮助java开发者自动生成javadoc文档注释
支持的IDEA版本为 2018.1 及以上
easy_javadoc - 图1
支持给中文起名字,类似程序员起名神器
easy_javadoc - 图2

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

    安装

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

    配置

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

    使用

  • 将光标放置到想要生成注释的类、方法或者属性上,然后按下快捷键ctrl \或者command \,即可生成注释,你的方法名起的越贴切,注释越得体。

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

当然,翻译不准的情况很常见,如果是因为单词翻译错误,可以在配置页面对自己的单词进行配置,自定义翻译的优先级大于其他。
腾讯和百度翻译都可以免费使用,需要自己申请相关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 \ 生成全部文档注释