C 文件注释中的 @ 符号有什么意义吗？

Question

如图，这里的 @ 符号仅仅是因为有高亮，所以注释看起来结构清晰吗。。

Answer 1

这种注释有一些工具能够识别并生成文档，比如 Doxygen。除了 @ 开头的字段，其实最开头那个「/**」也是指示，告诉文档生成工具来看这里。

Answer 2

嗯，有一些 IDE 会对 @ 字符做解析，来帮助 IDE 生成提示什么的。与 C 语言本身无关。

Answer 3

应该是Doxygen的指令。Doxygen是类似JavaDoc风格描述的文档系统，支持C/C++等语言。根据Doxygen规定的格式写注释，然后使用Doxygen就会自动生成文档。

不少语言都有自带的文档系统，如Java的JavaDoc，Doxygen与之类似；Rust更方便，支持Markdown，省去记各种指令的麻烦。

Answer 4

1. 注释内的内容不管是什么对编译器都是没有任何用的，因为编译器忽略注释所有内容

2. 这种写法的目的是为了其他工具来自动化生成文档用的，使用@可以让该工具识别关键词更加简单。

Answer 5

是的。
习惯而已。