1.简介
今天简单介绍下怎样使用StyleCop对原代码进行审查,看编写的代码是否遵循设计规范、.Net约定和一些贯用法等,保证代码的一致性,可读性等等,StyleCop 是用来检查代码是否符合设计规范的,它是基于原代码验证的,仅支持C#语言,就是在开发期间进行代码验证的工具,相信在日常开发中,会帮助到大家,在使用工具的同时,逐渐改善和提高大家的编码规范和意识
2.下载,安装
首先下载最新版的StyleCop,下载地址:http://stylecop.codeplex.com/
当前最新版本是StyleCop-4.7.37.0.msi,版本4.7,下载完成后,开始安装,安装过程非常简单,一路next,注意要先关闭vs
安装好后,在项目上右键会出现下面的菜单
在vs打开的文件邮件会多出如下菜单
运行run stylecop,错误列表中会出现警告,警告只能手动修改
3.设置,stylecop settings
4.常见的警告简单说明
SA1507 : CSharp.Layout : The code must not contain multiple blank lines in a row.
代码部分存在多个空格
SA1600 : CSharp.Documentation : The method must have a documentation header.
方法必须要头部说明,只要在方法前键入3个斜杠,IDE自动会根据该方法生成相关头文档说明
SA1400 : CSharp.Maintainability : The class must have an access modifier.
类必须要有一个访问修饰符,如:public、private等
SA1513 : CSharp.Layout : Statements or elements wrapped in curly brackets must be followed by a blank line.
语句之间要有空行
SA1202 : CSharp.Ordering : All private methods must be placed after all public methods.
私有方法要放在公有方法子后
SA1650 : CSharp.Documentation : The documentation text within the summary tag contains incorrectly spelled words: 异常测试
这个是对中文支持的不够好。拼写检查识别不到
其他还有常见的变量首字母小,常量首字母大写,等等常规检查,其它规则请参见StyleCop使用说明
5.和reshaper组合使用
可以通过edit profiles 来设置新的代码审查规则,当你同时安装了reshaper和stylecop时,新建规则中会多出如下图的选项
这也是两者的结合处,只能手动的把两者结合起来配置成一个规则,然后,code cleanup 选中test规则名,clean一下,代码就符合你设定的规则啦
还有,安装了stylecop,reshaper会自动调用stylecop规则来验证是否符合其规则,若是不符合规则,则不符合stylecop规则的警告也会出现在错误列表中