VS2019快捷说明性注释——C++

VS用来编写C系列程序是很方便的，特别是 C#，对于C++稍微差了点。特别是在怎么给文件自动添加头注释，网上大部分都是对于 C# 的修改，找了很久没有C++的。
所以只能迂回找了两种相似的办法。

一、修改创建新文件格式

1、新文件模板路径
大概路径一致，注意自己的年份和版本

C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\IDE\VC\vcprojectitems

2、修改文件 newc++file.cpp
保存即可

/*****************************************************************************
* @author  : ljf                                                             *
* @date    :                                                                 *
* @file    :                                                                 *
* @brief   :                                                                 *
*----------------------------------------------------------------------------*
*                           Change History                                   *
*----------------------------------------------------------------------------*
* Date        | Version   | Author         | Description                     *
*----------------------------------------------------------------------------*
*             |           |                |                                 *
*****************************************************************************/

3、现在新建空文件 .cpp 就自动会有以上信息

二、代码片段管理

MSDN官方文档：https://docs.microsoft.com/zh-cn/visualstudio/ide/walkthrough-creating-a-code-snippet?view=vs-2019

如果仅仅只是需要注释头部信息，上一种方法即可，还想要随时可以给函数一个快捷说明性注释，那推荐使用代码片段管理。相当于调用函数。

1、代码片段的代码路径
（1）系统代码片段路径

C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\IDE\VC\Snippets\2052\Visual C++

（2）自定义代码片段路径

C:\Users\ljf\Documents\Visual Studio 2019\Code Snippets\Visual C++\My Code Snippets

2、编写代码片段
格式：.snippet
例如：tip.snippet
尽量名字不要与官方的重复
这只是基本格式，不可能像 C# 一样可以自动注释时间，文件名那些（看了官方文档好像不行）
（1）注释头部信息 tip.snippet

<?xml version="1.0" encoding="utf-8"?>
<CodeSnippets >
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>tip</Title>
      <Shortcut>tip</Shortcut>
    </Header>
    <Snippet>
      <Code Language="cpp">
        <![CDATA[
/*****************************************************************************
* @author  : ljf                                                             *
* @date    :                                                                 *
* @file    :                                                                 *
* @brief   :                                                                 *
*----------------------------------------------------------------------------*
*                           Change History                                   *
*----------------------------------------------------------------------------*
* Date        | Version   | Author         | Description                     *
*----------------------------------------------------------------------------*
*             |           |                |                                 *
*****************************************************************************/
            ]]>
      </Code>
    </Snippet>
  </CodeSnippet>
</CodeSnippets>

（2）函数注释信息 note.snippet

<?xml version="1.0" encoding="utf-8"?>
<CodeSnippets >
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>note</Title>
      <Shortcut>note</Shortcut>
    </Header>
    <Snippet>
      <Code Language="cpp">
        <![CDATA[
/*****************************************************************************
* @data    :                                                                 *
* @input   :                                                                 *
* @output  :                                                                 *
* @brief   :                                                                 *
*****************************************************************************/
            ]]>
      </Code>
    </Snippet>
  </CodeSnippet>
</CodeSnippets>

3、VS添加自定义代码片段
（1）直接方式
直接把自己定义的代码片段放到自定义代码片段路径
（2）VS操作
工具——》代码片段管理器——》语言（Visual C++）——》My Code Snippets——》导入——》选择自己的保存代码片段

里面已经有我导入的一些自定义代码片段了

导入自己定义的代码片段

因为我已经导入过相同的，所以有警告，如果第一次不和任何冲突就直接成功，现在里面就有了自定义的代码片段，就可以使用了。

4、使用
输入自定义代码片段名，然后有提示点击回车

总结

代码片段还能够简便我们编写程序。
总的来说 VS 对 C# 更好。