IntelliJ IDEA外部注释的使用

2018-10-19 14:47 更新

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:如果启用了外部注释,则会显示此对话框。否则,默认情况下会将注释添加到源代码中。
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号