文章目录
引言
通常在Windows下开发,必装Visual Studio 系列,目前VS2017/2019比较常用,在早一点如2013/2015等,笔者刚好有一台电脑需要在全新的环境下搭建C++的开发环境,遂写文本记录一下,备忘。
VS2017安装
Assistx安装
- 下载。见链接:https://pan.baidu.com/s/17NmnRGgyAIUi5XiLUuzPPQ,提取码:5z0a
- 安装方法:解压后,先关闭vs2017,然后点击VA_X_Setup2223.exe下一步下一步即可。最后,把Crack/VA_X.dll文件替换一下即可永久使用该插件,不会提示过期。
- 打开vs2017,菜单中出现“VAssistX”代表成功。
下面说一下常用功能。
代码高亮
无需配置,VAssistX->Enable/Disable Visual VAssistX中可关闭插件,效果如下:
快速插入代码模板
这个插件很强大的一个功能就是可以插入一段代码模板,通过内置的宏,可以动态改变一些文本,比如文件名、时间、作者等等,从而省去了拷贝后手动要改时间的问题,提升效率。
模板介绍
- 点击“VAssistX->Tools->Edit VA Snippets…”,往下拉,找到“Doxygen - Header Comment”,Shortcut中输入“cmh”(意思是在文件中输入cmh,会显示快捷创建代码模块按钮,点击后即可把代码模板插入到文件中)或者其他任何字母
PS:
$FILE_BASE$,是一个宏(或者说占位符),会替换成文件名不带后缀的部分。
$FILE_EXT$,代表是文件名后缀。这样我们可以组合。
$YEAR$,$MONTY$,$DAY$,这个随着系统时间改变,分别代表年、月、日。中间以“/”分割。
更多的宏可以在$abc$中找到。
- 把以下代码粘贴替换。
/** @file $FILE_BASE$.$FILE_EXT$
* @brief
* @author summer sh
* @date $YEAR$/$MONTH$/$DAY$
*/
- 在文件中要插入代码模板的位置输入cmf,点击后可以快速添加文件头的声明。效果如下:
如果在config_dao.cpp中输入cmh,然后点击确定,“cim.cpp”就会变成“$file config_dao.cpp”,很方便。
新建模板
如果没有合适的模板,我们也可以新建一个,比如希望能在函数上增加注释。
- 点击新建New VA Snippet
- 如上图,输入自定义Title 、Shortcut 和 模板后点击OK即可,效果如下:
- 在文件中输入cmf快捷键,插入这段自定义的代码模板。
- 下图是一些示例。
常用模板汇总
这里给几个常用的模板,工作中会经常用到。
文件头说明cmh
- title:Doxygen - Header Comment
- shortcut:cmh
/** @file $FILE_BASE$.$FILE_EXT$
* @brief
* @author summer sh
* @date $YEAR$/$MONTH$/$DAY$
*/
函数注释cmf
- title:Doxygen - Function Comment
- shortcut:cmh
/** @fn initChatKit
* @brief
* @param
* @return
*/
防重复包含chg
- title:Doxygen - File Guid
- shortcut:chg
#ifdef _$FILE_BASE_UPPER$_$GUID_SYMBOL_UPPER$_
#define _$FILE_BASE_UPPER$_$GUID_SYMBOL_UPPER$_
#endif // _$FILE_BASE_UPPER$_$GUID_SYMBOL_UPPER$_
效果如下:
c++11 Range-Based-For fori
- title:for loop c++11 range based
- shortcut:fori
for (auto& item : $selected$) {
}
$selected$代表鼠标占位,会自动把鼠标跳转到这个位置,这样我们就可以快速输入要便利的容器了。
Doxygen
是C++的文档注释生成工具,网易云IM的SDK文档就是用工具自动生成的。
更多信息可以参考Doxygen官网。
AStyle代码格式化插件
安装
- 下载 https://marketplace.visualstudio.com/items?itemName=Lukamicoder.AStyleExtension2017
- 打开AStyleExtension.vsix安装。
- VS2017菜单->工具->选项,出现ASytle Formatter代表成功。
代码格式化风格配置
- 点击Edit,把下面配置粘贴进去。
--style=google --indent=spaces=4 --align-pointer=type --indent-classes --indent-namespaces --break-blocks --break-blocks=all --pad-oper --pad-header --mode=c--style=google --indent=spaces=4 --align-pointer=type --indent-classes --indent-namespaces --break-blocks --break-blocks=all --pad-oper --pad-header --mode=c
5. 勾选"Format on Save“,即保存文件时,自动格式化,无需按快捷键。
6. 任意打开文件,按Ctrl + S保存,查看格式化效果。
补充说明:
–style=google代表使用google c++代码风格,可以看到格式化前{}单独占一行,格式化后则第一个{和函数名在同一行。google c++代码规范可以参考这里:Google 开源项目风格指南 (中文版) C++ 风格指南
总结
至此,VS2017的常用插件配置完毕,足够日常使用了,如果有更用好的插件,欢迎评论留言。