Java 18 新增@snipppet标签，注释中写样例代码更舒适了！

在这次的Java 18中，新增了一个@snipppet标签，主要用于JavaDoc中需要放示例代码的场景。其实在Java 18之前，已经有一个@code标签，可以用于在JavaDoc中编写小段的代码内容，比如在之前介绍Simple Web Serveropen视频中

提到的这段样例代码，就是用@code标签来写的：

 * <p> Example of a simple file server:
 * <pre>{@code
 *    var addr = new InetSocketAddress(8080);
 *    var server = SimpleFileServer.createFileServer(addr, Path.of("/some/path"), OutputLevel.INFO);
 *    server.start();
 * }</pre>

虽然以前版本已经有类似功能，但依然还有各种各样的缺点，所以这次的@snipppet标签就在这些方面做了增强：

• 有效性检查，比如：当我们的样例代码中包含部分语法错误的时候，将会出现错误提示

• 语法高亮，如下图所示，使用@snippet的时候，IDE已经可以支持高亮，更有利于编辑，对比下@code的 内容，编辑的时候就没那么舒服了

• 代码编辑时的IDE支持也有了很大的提升，以往使用@code来编辑代码的时候基本就是当纯文本来编辑的，而现在在使用@snippet的时候，IDE给出了更多更好的支持，比如大家最喜欢的代码提示：

所以，这个功能DD觉得还是非常有用的，尤其是对于一些写框架和SDK的小伙伴（毕竟对JavaDoc的要求高）。

本篇内容对应视频已完成录制，点击查看：

我们创建了一个高质量的技术交流群，与优秀的人在一起，自己也会优秀起来，赶紧点击加群，享受一起成长的快乐。另外，如果你最近想跳槽的话，年前我花了2周时间收集了一波大厂面经，节后准备跳槽的可以点击这里领取！

推荐阅读

··································

你好，我是程序猿DD，10年开发老司机、阿里云MVP、腾讯云TVP、出过书创过业、国企4年互联网6年。从普通开发到架构师、再到合伙人。一路过来，给我最深的感受就是一定要不断学习并关注前沿。只要你能坚持下来，多思考、少抱怨、勤动手，就很容易实现弯道超车！所以，不要问我现在干什么是否来得及。如果你看好一个事情，一定是坚持了才能看到希望，而不是看到希望才去坚持。相信我，只要坚持下来，你一定比现在更好！如果你还没什么方向，可以先关注我，这里会经常分享一些前沿资讯，帮你积累弯道超车的资本。点击领取2022最新10000T学习资料

点击 阅读原文，直达我正在连载的 Java前沿系列教程