VS：创建项模板（新建文件后自动在其中添加代码）

骑猪看日落 2023-06-25 02:15 15阅读 0赞

### VS：创建项模板（新建文件后自动在其中添加代码） ###

*  1. 背景
 *  2. 实现步骤
 *  3. 参考文献

--------------------

# 1. 背景 #

使用VS2017进行C++编程，在项目中添加新建项，创建cpp文件以实现函数。新建cpp时需要添加一些相关的文件信息，如文件名，创建时间，固定代码模块等。如果新建多个这样的文件，每次复制这些信息嫌麻烦，现希望在VS**创建项模板**以实现**新建项后自动添加文件信息**。

![C++项目][C]

![新建项][format_png_pic_center]

每次新建项希望自动添加的代码：

// 文件名：
    // 创建时间：
    
    #include "pch.h"
    #include <iostream>
    
    int main_1()
    {
    
    	return 0;
    }

# 2. 实现步骤 #

**1. 新建1.cpp作为项模板，修改所需自动添加的代码。新建不同cpp可变化的内容参考下表中的模板参数。**

// 文件名：$itemname$
    // 创建时间：$time$
    
    #include "pch.h"
    #include <iostream>
    
    int main_$itemname$()
    {
    
    	return 0;
    }

<table> 
 <thead> 
  <tr> 
   <th>模板参数</th> 
   <th align="left">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>clrversion</td> 
   <td align="left">公共语言运行时 (CLR) 的当前版本。</td> 
  </tr> 
  <tr> 
   <td>ext_*</td> 
   <td align="left">将 ext_ 前缀添加到任何参数，以引用父模板的变量。<br> 例如 ext_safeprojectname。</td> 
  </tr> 
  <tr> 
   <td>guid[1-10]</td> 
   <td align="left">一个用于替换项目文件中的项目 GUID 的 GUID。<br> 可指定最多 10 个唯一的 GUID（例如，guid1）。</td> 
  </tr> 
  <tr> 
   <td>itemname</td> 
   <td align="left">在其中使用参数的文件的名称。</td> 
  </tr> 
  <tr> 
   <td>machinename</td> 
   <td align="left">当前的计算机名称（例如，Computer01）。</td> 
  </tr> 
  <tr> 
   <td>projectname</td> 
   <td align="left">创建项目时由用户提供的名称。</td> 
  </tr> 
  <tr> 
   <td>registeredorganization</td> 
   <td align="left">来自 HKLM\Software\Microsoft\Windows NT\CurrentVersion\RegisteredOrganization 的注册表项值。</td> 
  </tr> 
  <tr> 
   <td>rootnamespace</td> 
   <td align="left">当前项目的根命名空间。 此参数仅适用于项模板。</td> 
  </tr> 
  <tr> 
   <td>safeitemname</td> 
   <td align="left">与 itemname 相同，但所有不安全字符和空格替换为了下划线。</td> 
  </tr> 
  <tr> 
   <td>safeitemrootname</td> 
   <td align="left">与 safeitemname 相同。</td> 
  </tr> 
  <tr> 
   <td>safeprojectname</td> 
   <td align="left">用户在创建项目时提供的名称，但名称中删除了所有不安全字符和空格。</td> 
  </tr> 
  <tr> 
   <td>time</td> 
   <td align="left">以 DD/MM/YYYY 00:00:00 格式表示的当前时间。</td> 
  </tr> 
  <tr> 
   <td>specifiedSolutionName</td> 
   <td align="left">解决方案的名称。 <br>在选中“创建解决方案目录”时，specifiedSolutionName 具有解决方案名称。 <br>在未选中“创建解决方案目录”时，specifiedSolutionName 为空。</td> 
  </tr> 
  <tr> 
   <td>userdomain</td> 
   <td align="left">当前的用户域。</td> 
  </tr> 
  <tr> 
   <td>username</td> 
   <td align="left">当前的用户名称。</td> 
  </tr> 
  <tr> 
   <td>webnamespace</td> 
   <td align="left">当前网站的名称。 <br> 此参数在 Web 窗体模板中用于保证类名是唯一的。 <br> 如果网站在 Web 服务器的根目录下，则此模板参数解析为 Web 服务器的根目录。</td> 
  </tr> 
  <tr> 
   <td>year</td> 
   <td align="left">以 YYYY 格式表示的当前年份。</td> 
  </tr> 
 </tbody> 
</table>

**2. 导出项模板**

![导出项模板][format_png_pic_center 1]

![选择模板类型][format_png_pic_center 2]

![选择导出的项][format_png_pic_center 3]

![选择项引用][format_png_pic_center 4]

![选择模板选项][format_png_pic_center 5]

![模板输出位置][format_png_pic_center 6]

![模板启动位置][format_png_pic_center 7]

> 模板输出位置：C:\\Users\\Administrator\\Documents\\Visual Studio 2017\\My Exported Templates  
> 模板启动位置：C:\\Users\\Administrator\\Documents\\Visual Studio 2017\\Templates\\ItemTemplates  
> **注意：模板输出位置与模板启动位置并不相同，在VS中真正起作用的是模板启动位置。new template.zip无需解压。**  
> 如果需要本文所用的项模板，可直接点击[new template.zip][]下载。

**3. 重启VS，新建2.cpp，可发现代码已自动添加。**  
![选择new template模板新建2.cpp][new template_2.cpp]

![自动添加的代码][format_png_pic_center 8]

# 3. 参考文献 #

1.  [如何：创建项模板][Link 1]
2.  [模板参数][Link 2]

[C]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC0wYjZlMWE1YzQ1OGJlZTIwLnBuZw?x-oss-process=image/format,png#pic_center
[format_png_pic_center]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC0wZWZmZTdhZTEyZjViYjBhLlBORw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC03MjM2MWRkODU5NTMxZTQ3LlBORw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC04ODBkNjVlZGFiZjY5ZGE1LnBuZw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC0yMWMwYmM2N2RmOGJlMjdjLnBuZw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 4]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC1hZmY5NzU4ODhjMTEyNzEwLnBuZw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 5]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC05OWZhYjgxNDIwMGUwN2ViLnBuZw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 6]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC1lYTgzMjFhMjExZDAyNjVkLnBuZw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 7]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC1hZGZmZTJhYTNlNjhjNTBjLlBORw?x-oss-process=image/format,png#pic_center
[new template.zip]: https://download.csdn.net/download/qq_34801642/12048969
[new template_2.cpp]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC1iOGQ0MThlMzhjNTM5NDNmLnBuZw?x-oss-process=image/format,png#pic_center
[format_png_pic_center 8]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8yMDMwMzQzNC00NTRhZWM5ZWFhYmI1ZWEzLnBuZw?x-oss-process=image/format,png#pic_center
[Link 1]: https://docs.microsoft.com/zh-cn/visualstudio/ide/how-to-create-item-templates?view=vs-2017
[Link 2]: https://docs.microsoft.com/zh-cn/visualstudio/ide/template-parameters?view=vs-2017