本文将讲解C程序注释模板的使用背景、创建方法，并在结束时进行总结。
1、使用背景
在项目开发过程中，为方便组内其他成员能够快速学习自己编写的代码，需要对自己写的函数添加注释。在正规的软件开发流程中，一个标准的函数及其注释可能如下所示。
/************************************************************************
Function: ParseBinFile Description: 解析Bin文件数据 Parameter: binFileNameLen --[in] bin文件名长度
binFileName --[in] bin文件名
resultDataLen --[out] 目标数据长度
resultData --[out] 目标数据 Return: 0, 执行成功
非0, 执行失败 ************************************************************************/
int ParseBinFile(int binFileNameLen,char *binFileName,int resultDataLen, char *resultData)
{
return ;
}
如果在项目中需要推广函数+注释这种编程规范，那么最笨最简单的方法是：手写一个通用的注释段，然后依次进行copy，但是这种方法需要大量的手动操作，既低效又易出错。
如果使用的是Java语言，那么可以采用现成的Javadoc工具，为每一个类、方法添加注释模板，其格式如下所示：
/**
* The doGet method of the servlet.
* This method is called when a form has its tag value method equals to get.
*
* @param request
* the request send by the client to the server
* @param response
* the response send by the server to the client
* @throws ServletException
* if an error occurred
* @throws IOException
* if an error occurred
*/
public void doGet (HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doPost(request, response);
}
Visual C++6.0中不具备像Javadoc这样注释自动生成工具，那么只能依靠插件Visual AssistantX进行辅助。
2、创建方法
2.1、在Visual C++6.0中安装Visual Assistant X；
a、找到破解版Visual Assitant X（一个小的软件下载网站），笔者用的版本是V10.0.1233.0；
b、直接点击Setup目录下的VA_X_Setup1230.exe进行安装；
c、将CR目录下的文件拷贝至安装路径，双击VA_X.reg，进行注册表注册；
2.2、编写注释模板；
a、打开Visual Assistant X的工具栏，点击Visual Assistant X Option，选择“Autotext/Templates”
b、在右侧页面中添加注释模板。注意：代码中FF是模板结束标志，等同于上图中FF
/*+:
/************************************************************************
Function: Description: Parameter: --[in]
--[out]
--[in/out] Return: 0, SUCCESS
Other, FAILURE Note: Others: Attention:
************************************************************************/FF
2.3、实例应用；
在VC++6.0中打开一个C源文件，敲击/*+，即可自动生成注释：
3、总结
充分利用Visual Assistant 中的模板功能，可以拓展VC++6.0的功能，让代码编写更加简单、快捷。