Dart是否有类似Javadoc中@literal的注释转义特性?
Dart注释中避免转义尖括号的替代方案
Dart的文档注释支持{@code}标签,能实现类似Javadoc里@literal的效果,不用手动转义<、>这类特殊字符,让注释可读性更高。
比如要在注释里写MyType<String>,直接这么写就行:
/// {@code MyType<String>}
如果需要多行代码格式,也可以用代码块包裹(注意在文档注释内要保持缩进):
/// ``` /// MyType<String> /// ```
Dartdoc里的{@code}会原样渲染包裹的内容,不会解析其中的HTML转义字符或Markdown语法,完全满足替代@literal的需求。
内容的提问来源于stack exchange,提问作者eastwater
相关产品推荐
相关产品推荐

