**Java 18 @Snippet 标签亮相：注释中的样例代码更添便捷！**

在众所期待的 Java 18 中，一个名为 @snippet 的新标签闪亮登场，它专为 JavaDoc 中示例代码而生。毫无疑问，这将极大提升开发人员在注释中编写样例代码的舒适度。事实上，在 Java 18 之前，JavaDoc 中已经存在一个 @code 标签，同样适用于示例代码编写。

@Snippet 与 @Code 标签对比

@snippet 和 @code 标签都是用于在 JavaDoc 中编写代码示例的，但它们之间存在一些关键差异：

• 语法不同： @snippet 标签的语法为 @snippet <语言> <代码> <语言>，其中<语言>表示代码示例的语言，<代码>表示代码示例本身。而 @code 标签的语法则为 @code <代码>，没有指定代码示例语言。
• 代码示例的位置不同： @snippet 标签可以放置在任意位置，而 @code 标签只能放置在段落或列表项内。
• 代码示例的格式不同： @snippet 标签生成的代码示例具有语法高亮和行号，而 @code 标签生成的代码示例则没有。

@Snippet 标签使用方法

使用 @snippet 标签非常简单，只需在需要放置代码示例的位置添加以下代码即可：

例如：

/**
 * 计算两个数字的和。
 *
 * @param a 第一个数字
 * @param b 第二个数字
 * @return 两个数字的和
 *
 * @snippet java
 * public static int sum(int a, int b) {
 *     return a + b;
 * }
 * ```

### Java 18 其他注释体验改进
除了 `@snippet` 标签，Java 18 还对注释体验进行了其他改进，包括：

* **支持 HTML 代码：**  在 Java 18 中，注释中可以包含 HTML 代码，这使得注释更加丰富和美观。
* **支持 Markdown 语法：**  在 Java 18 中，注释中可以使用 Markdown 语法，这使得注释更加易读和易写。
* **改进的代码格式化：**  在 Java 18 中，注释中的代码可以自动格式化，这使得注释更加整洁和美观。

## 总结
`@snippet` 标签的引入以及其他注释体验改进使 Java 18 成为开发人员的福音。相信这些改进将进一步提升 Java 开发的便利性，让开发人员能够更加专注于创造出色的软件。