Visual Studio自动完成C++的Doxygen标签

Question

有没有一种方法让Visual Studio自动在C++源文件中放置Doxygen标签呢？

我的意思是例如这段代码：

int foo(bool p);

如果我在上面输入///，Visual Studio会自动生成以下行：

/// <summary>
/// 
/// </summary>
/// <param name="p"></param>
/// <returns></returns>
int foo(bool p);

我的问题是：使用doxygen是否可以做到与此相同（当我键入/**时）？使VS生成以下内容：

   /**
    * @brief
    * @param p
    * @return
    */
    int foo(bool p)

我的问题是关于编写文档标签（而不是生成最终的Doxygen文档）。

- Pierre Baret

---

也许https://stackoverflow.com/questions/38260751/keyboard-shortcut-customizing-in-visual-studio-2013提供了一些提示，或者https://dev59.com/_XVD5IYBdhLWcg3wNYxZ。 - albert

对于旧版的VisualStudio，有这样的插件。DoxyComment - C/C++ documentation tools，DoxyComment - files - kunif

我对第一个带有///注释的情况很感兴趣。你是如何让Visual Studio自动生成它的？对我来说，它只在C#中有效，而不在C++中有效，我很想在C++中使用它。提前致谢！ - Ranjeeth Mahankali

据我所记，我在C++中没有配置任何特殊内容来使///正常工作。但是我正在处理的项目有一个用于UI的C#部分和一个用于处理的本地C++部分... - Pierre Baret

Answer 1

在VS19中有一个设置可以实现这一点:

工具 > 选项 > 文本编辑器 > C/C++ > 代码风格 > 常规 > 生成的文档注释样式

将其设置为 Doxygen (/**)

- Iizuki

---

截至VS 16.1.3，我没有看到这个选项。C/C++没有“CodeStyle”部分。 - Tyler Shellberg

我目前正在运行16.6.3版本。猜测他们是在其中某个版本中添加了它。 - Iizuki

只是确认一下，我在VS2019 16.7.1中有它。 - hardyVeles

这很有帮助，但输出仍然使用///来开始每一行，而不是用星号的约定。 - Farnsworth

选项在VS 2019 16.11.6中存在。样式“///”和“//!”通过键入并按回车触发，样式“/*”和“/!”仅通过按“Ctrl + /”触发。 - user74696c

现在有一个问题：触发器“Ctrl + /”仅适用于英语键盘，其中“/”是单独的一个键。但例如，在德语键盘上，您需要按“Ctrl + Shift + 7”，这并不起作用。 - user74696c

Answer 2

我不知道为什么在Visual Studio Marketplace搜索时没有弹出此内容，但是可以使用/*! doxygen标签来完成任务。 https://marketplace.visualstudio.com/items?itemName=dragospop.CppDoxyComplete 示例：

/*!
 * 
 * 
 * \param b
 * \return 
 */
int foo(bool b)

- Pierre Baret

Answer 3

我不知道为什么在Visual Studio Marketplace搜索时没有弹出这个内容。

对于VS2019和VS2022版本，有另一个基于CppDoxyCompletion的扩展程序（链接），但具有更多功能。

- Fingeg