codecamp

IntelliJ IDEA外部注释的使用

IntelliJ IDEA 外部注释

在您使用 IntelliJ IDEA 注释源代码的时候,您需要考虑这样的一个情况:如果需要用 @Nullable/@NotNull 或 @NonNls 注释符号,但是要避免在源代码中注释。这可能是一个团队在一个项目上工作时使用了不同的 IDE(例如 IntelliJ IDEA 和 Eclipse),或在使用库类时会出现。

这种情况下 IntelliJ IDEA 建议使用存储在源代码之外的外部注释。有关注释符号的信息存储在 XML 文件中,而不是源代码中。每个条目将一个方法参数或返回值映射到所需的注释类。

此类文件具有名称:annotations.xml,并位于依赖于特定注释的来源的路径中。如果某个注释属于与您的项目配置的 SDK,则该路径将在 SDK 设置中进行定义。如果注释属于模块,则应在模块设置中定义路径。

本节将简要说明 IntelliJ IDEA 的外部注释。要了解如何启用、配置和创建外部注释,请参阅使用外部注释的部分。

IntelliJ IDEA 使用外部注释

如果您想要 IntelliJ IDEA 使用外部注释,您必须启用此功能,并指定将存储外部注释的目录。

如何启用 IntelliJ IDEA 外部注释

  1. 在 "Java 代码样式" 页的 "代码生成" 部分中,选中 "使用外部批注" 复选框。
    IntelliJ IDEA 使用外部注释
  2. 应用更改并关闭对话框。

在 SDK 级别定义外部注释的路径

  1. 打开 “项目结构”对话框(例如按:Ctrl+Shift+Alt+S)。
  2. 在"平台设置" 部分中,单击 "SDK"。
  3. 在 SDK 页面中,选择“注释”选项卡。
  4. 单击“添加”按钮,并在“选择路径”对话框中指定所需的路径。您可以根据需要创建任意数量的注释路径。
  5. 应用更改并关闭对话框。

IntelliJ IDEA 定义模块的外部注释的路径

  1. 在项目的上下文菜单中,选择“模块设置”。“项目结构”对话框显示在“模块”页面上。
  2. 选择“路径”选项卡。
  3. 在“外部注释”部分,单击 "添加",并在 "选择路径" 对话框中指定所需的路径。您可以根据需要创建任意数量的注释路径。
  4. 应用更改并关闭对话框。

使用 IntelliJ IDEA 外部注释来注释符号

按照以下一般步骤操作:

  1. 如果代码检查提醒您需要对符号进行注释,请按 Alt+Enter 以显示意图操作列表,然后选择适当的注释命令,例如:
    使用 IntelliJ IDEA 外部注释来注释符号
  2. 在打开的对话框中,单击“添加外部”按钮。

    使用 IntelliJ IDEA 外部注释来注释符号
    note:如果启用了外部注释,则会显示此对话框。否则,默认情况下会将注释添加到源代码中。
IntelliJ IDEA怎么使用@Contract注释
IntelliJ IDEA如何创建文档注释
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

IntelliJ IDEA的一般准则

什么是IntelliJ IDEA项目

使用IntelliJ IDEA的意图行为

IntelliJ IDEA使用运行/调试配置

特定于VCS的程序

IntelliJ IDEA语言和特定框架指南

IntelliJ IDEA的数据库和SQL功能

IntelliJ IDEA使用之JavaServer Faces(JSF)

IntelliJ IDEA:分析PHP应用程序的性能

IntelliJ IDEA:调试PHP应用程序

IntelliJ IDEA:适用于PHP的Google App Engine

IntelliJ IDEA更多内容

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }