为什么评论以“//！”开头Qt Creator中的蓝色？

Question

Qt Creator通常会将注释颜色设置为绿色，但我在Qt示例中看到了蓝色的注释，而Qt Creator似乎会将每个以//!开头的注释添加为蓝色。

以下是一个示例屏幕截图：

这是一些惯例吗？蓝色表示什么？

Answer 1

它是Doxygen comment。

有多种风格：

Qt阻止评论：

/*!
... text ...
*/

Qt单行评论：

//! ... one line of text ...

JavaDoc阻止评论：

/**
  * ... text ...
*/

JavaDoc单行注释：

/// ... one line of text ...

Answer 2

以//!开头的注释是代码文档的Qt样式，与常规注释形成对比。有关其结构的详细信息，请参阅the doxygen manual，但基本上，这些注释用于自动提取到有关代码的文档中。