如何在{@code}标签中嵌入星号斜杠组合*/？

当你在Javadoc的{@code}标签里直接写{@code */*}时，Javadoc工具会误将其中的*/识别为注释块的结束标记，从而抛出语法错误：

error: illegal start of type
{@code /}.
^

除了你用的拆分{@code}标签的临时方案，还有两种更简洁的最优方案：

• HTML实体转义关键字符：把斜杠用HTML实体转义，让Javadoc不会误识别注释结束标记。写法如下：

  {@code */*}
  

  最终显示效果就是*/*，且能正常通过Javadoc编译。

• 混合使用{@code}和{@literal}：用{@literal}包裹容易触发解析错误的/*部分，嵌套在{@code}里：

  {@code *{@literal /*}}
  

  这种写法同样能避免Javadoc的语法错误，同时保留代码样式。

你之前尝试的HTML转义无效，大概率是转义的位置不对——必须确保转义后的字符不会被Javadoc当成注释结束标记，上述两种写法都能解决这个问题。

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