如何更改从'///'生成的代码注释模板的Visual Studio默认输出

时间:2020-08-20 23:32:26

标签: c++ visual-studio

首先,我只在10年前就发现了一个关于stackoverflow的类似问题,如果这个问题被标记为多余,请不要引用该问题。

下一步,我不确定此功能是来自VS还是我可能已安装的扩展程序。

问题是,当我输入'///'时,会得到以下用于添加标题注释的默认框架:

/// <summary>
/// 
/// </summary>
/// <param name="sample_input"></param>
/// <param name="sample_output"></param>
/// <returns></returns>

如何将其更改为类似于Doxygen的常用格式?

/*
** @brief
** @param
** @return
*/

除了询问如何更改此默认行为外,我还想知道上面显示的第一种格式是否对Doxygen友好。

编辑:一些有用的答案和链接,但是我仍然想生成doxy注释,以使用带星号的约定而不是'///'来开始每一行。

1 个答案:

答案 0 :(得分:1)

如果使用从“ v16.6”开始的“ Visual Studio 2019”,请执行以下步骤:

要切换到Doxygen,请转到Tools > Options > Text Editor > C/C++ > General,然后选择您喜欢的文档样式:

指定后,您可以通过在函数上方键入相应的////**或使用(Ctrl + /)快捷方式来生成注释。

最终结果将是:

引自:Here