是否存在Javadoc官方或通用自定义@example标签用于展示方法示例用例？

Javadoc本身没有官方内置的@example标签，但行业里有一套通用的自定义标签方案，同时也有官方推荐的示例展示方式：

• 通用自定义@example标签：
  很多Java项目会自定义@example标签来标注方法的使用示例，就像你给出的代码示例那样，配合{@code}标签来格式化代码片段。这种写法非常普遍，主流IDE（比如IntelliJ IDEA、Eclipse）都能识别并将其渲染成易读的格式，开发者之间也能快速理解示例含义。

• Javadoc官方推荐的示例写法：
  如果不想用自定义标签，也可以直接在Javadoc的描述段落里，用<pre>标签配合{@code}来包裹示例代码，官方文档也常用这种方式：

  /**
   * Returns the sum of all the elements in an integer array.
   * 
   * @param numbers Array of integers to be summed.
   * <p>示例用法：
   * <pre>{@code
   * int total = sum(1, 2, 3);
   * // 输出结果为6
   * }</pre>
   */
  public int sum(int... numbers) {
      // 方法实现
  }
  

• 第三方扩展支持：
  部分Javadoc扩展插件（比如一些文档生成工具）会提供更丰富的示例标签，但这些不属于Javadoc原生功能，需要额外配置依赖。

你示例里使用的@example标签属于行业通用的自定义方案，是非常实用且被广泛接受的写法。

内容的提问来源于stack exchange，提问作者Darragh