VS Code Cpptools扩展Doxygen@brief后换行丢失，如何在悬停信息中保留换行？

AI 小北

2026-7-18

解决VS Code C/C++扩展Doxygen @brief注释换行不显示问题

针对VS Code C/C++扩展v1.15.4中，Doxygen注释里@brief关键字后的换行在悬停信息中无法保留的问题，以下是无需生成HTML文档、仅优化悬停显示的解决方法：

使用HTML换行标签<br>
VS Code的悬停信息组件支持解析简单HTML标签，直接在需要换行的位置插入<br>即可强制换行，示例代码：
```
/**
    @brief Function # 1.<br>
           Newline now working.
*/
void foo(int) {}

int main()
{
    foo(1);
    return 0;
}
```
改用@par标签实现分段
若不想引入HTML标签，可通过@par标签创建新段落，配合缩进实现换行效果，示例：
```
/**
    @brief Function # 1.
    @par
        Newline now working.
*/
void foo(int) {}
```
升级扩展版本（可选）
v1.15.4属于旧版本，该Doxygen注释渲染bug在后续更新中大概率已被修复，若项目允许，升级到最新版C/C++扩展可直接解决问题。