如何让VS Code中注释生成的悬停提示正确显示换行效果

可行解决方案 #

• 优先更新C/C扩展到最新正式版：你遇到的注释换行合并问题是C/C扩展的历史bug，官方虽标注已修复，但你当前使用的旧版VSCode配套的扩展版本可能未包含修复补丁，更新后可先复测效果
• 调整Doxygen标签的书写格式：如果需要保留@brief、@param等标签的使用，有两种方式避免换行被吞：
  1. 每个标签对应的描述内容换行后，行首加两个空格再书写；或者每段描述的末尾加两个空格，可强制触发换行展示
  2. 把@brief等标签单独占一行，后续的描述内容另起段落书写，不要直接跟在标签同一行后换行
• 关闭Doxygen解析功能：如果不需要使用Doxygen语法，直接打开VSCode设置，搜索C_Cpp: Doxygen Enable，关闭对应选项即可。关闭后注释会按纯文本格式保留原始换行，不会被语法解析规则合并成一行
• 无需使用注释标签的场景下，直接用无标签的纯块注释即可，每一行注释以* 开头、单独占行，悬浮时就能正常保留换行格式

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