IDEA 添加类注释、方法注释(快捷键 /** + Enter)

本文介绍了如何在 IntelliJ IDEA 中设置类注释和方法注释的快捷方式。通过 File–Setting–Editor–File and Code Templates 可定制类注释模板,使用 Live Templates 创建方法注释模板,设置 Abbreviation 为 '*' 并将 Expaned with 设为 Enter,实现快捷键 /** + Enter 功能。在 Live Templates 中定义变量如 params、date、time、author 和 return,利用 groovyScript 调整参数格式,使注释更高效。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

类注释

File–Setting–Editor–File and Code Templates–Class

注释模板:

/**
 * @description: 
 * @author: ${USER}
 * @time: ${DATE} ${TIME}
 */

 

方法注释

 

  • 为了获取参数信息,我们需要使用 “ Live Templates” 。

  • 创建 Live Templates 分组

    • File–Setting–Live Templates。
      在这里插入图片描述
  • 创建 Template

    • 我们上一步创建了 zwl 分组,现在我们将在 zwl 分组中创建 Template。
    • 注意:Abbreviation 的名字为 * ,Expaned with Enter,这样注释功能的快捷键就为 :/** + Enter
    • 右键模板,选择 change context:定义模板的是适用范围,这里选择Java所有即可

 

模板内容:

*
 * @description: 
$params$
 * @return: $return$
 * @author: $user$
 * @time: $date$ $time$
 */

定义模板内容中引用的变量

  • 我们上一步的截图中,点击 Edit variables 按钮可以弹出变量设置窗口。
  • 这里,我们把参数变量 params 设置为一个自定义函数 groovyScript() 。groovyScript 函数调用 Idea 的 methodParameters() 函数获得参数数组,并进行格式化。
    • params 的值(即 groovyScript 函数):
    • 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())
      

       

  • 其他变量的值,直接使用 Idea 的函数进行赋值。
    • date → date()
    • time → time()
    • author → user()
    • return → methodReturnType()

 

最终效果:

### 在代码编辑器中使用 /**/ 快捷键方法 #### 1. **Atom 编辑器** 在 Atom 中,默认并没有提供直接生成 `/* */` 的快捷键,但可以通过安装插件来实现这一功能。通过使用 `multi-comment` 插件[^1],可以自定义快捷键以快速生成块注释。 - 安装 `multi-comment` 插件后,修改其配置以支持 `Ctrl + Shift + /` 快捷键。 - 配置完成后,选中文本并按快捷键即可生成带有空格的 `/* */` 块注释。 ```plaintext /* * 这里是注释内容 */ ``` --- #### 2. **IntelliJ IDEA 编辑器** 对于 IntelliJ IDEA 用户而言,可以直接利用内置的快捷键组合来生成块注释[^2]。 - Windows/Linux 平台下,使用 `Ctrl + Shift + /` 来包裹选定的文本为块注释。 - macOS 平台下,则使用 `Cmd + Shift + /` 实现相同的效果。 此外,还可以通过自定义模板进一步扩展注释样式,满足特定需求。 --- #### 3. **Visual Studio Code (VSCode)** VSCode 提供了灵活的方式来自定义生成 `/* */` 注释快捷键[^3]。 ##### 方法一:默认快捷键 - 对于已选中的代码块,按下 `Shift + Alt + A`(Windows/Linux)或 `Shift + Option + A`(macOS),即可将其包围在 `/* */` 当中。 ##### 方法二:创建自定义代码片段 如果希望更加便捷地插入带格式化的块注释,可通过以下步骤完成个性化设置: 1. 打开 VSCode 设置界面 (`File -> Preferences -> User Snippets`); 2. 创建新的全局代码片段文件(如命名为 `javascript.json` 或其他适用的语言环境); 3. 添加如下 JSON 配置内容: ```json { "Block Comment": { "prefix": "blockcmt", "body": [ "/**", " * ${1:Your comment here}", " */" ], "description": "Inserts a block-style comment with proper formatting." } } ``` 保存之后,在对应语言环境下输入触发词(此处为 `blockcmt`),再敲击 Enter 键便可迅速构建所需的多行注释结构。 --- #### 4. **Java 环境下的具体实践** 针对 Java 开发者来说,部分 IDE 已经集成了高效的工具栏选项以及关联按键用于处理此操作[^4]。例如 Eclipse 和 NetBeans 支持的标准做法同样是借助 `Ctrl + Shift + /` 组合键达成目标;而 Android Studio 则延续了 JetBrains 系列产品的传统设计思路——允许用户自由调整偏好设定从而适配个人习惯。 --- #### 总结 无论选用哪种主流代码编辑软件,均能找到合适途径去简化日常工作中频繁涉及的操作流程。熟悉这些技巧不仅有助于提高效率,还能让源码显得更具可读性和条理性。
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值