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 外部注释
- 在 "Java 代码样式" 页的 "代码生成" 部分中，选中 "使用外部批注" 复选框。
- 应用更改并关闭对话框。
在 SDK 级别定义外部注释的路径
- 打开 “项目结构”对话框（例如按：Ctrl+Shift+Alt+S）。
- 在"平台设置" 部分中，单击 "SDK"。
- 在 SDK 页面中，选择“注释”选项卡。
- 单击“添加”按钮，并在“选择路径”对话框中指定所需的路径。您可以根据需要创建任意数量的注释路径。
- 应用更改并关闭对话框。
IntelliJ IDEA 定义模块的外部注释的路径
- 在项目的上下文菜单中，选择“模块设置”。“项目结构”对话框显示在“模块”页面上。
- 选择“路径”选项卡。
- 在“外部注释”部分，单击 "添加"，并在 "选择路径" 对话框中指定所需的路径。您可以根据需要创建任意数量的注释路径。
- 应用更改并关闭对话框。
使用 IntelliJ IDEA 外部注释来注释符号
按照以下一般步骤操作：
- 如果代码检查提醒您需要对符号进行注释，请按 Alt+Enter 以显示意图操作列表，然后选择适当的注释命令，例如：
-
在打开的对话框中，单击“添加外部”按钮。
note：如果启用了外部注释，则会显示此对话框。否则，默认情况下会将注释添加到源代码中。