5

我目前正在为 COM 对象编写一个开源包装器。我刚刚安装了 StyleCop 并针对我的一些代码运行它,正如我所料,它引发了大量警告(其中一些我应该已经在做,例如将“this.”添加到所有本地方法调用和变量中)

我应该尝试减少多少这些警告?在编写开源库时,哪些是最好的?

4

2 回答 2

5

StyleCop 的总体思路是:所有这些 :)

您关闭的选项越多,StyleCop 在强制执行单一代码格式方面的价值就越小。话虽如此,如果您不喜欢某些选项,那么某些选项总比没有好,请将 StyleCop 设置文件包含在您的代码中,其他处理它的人可以使用相同的设置。

如果您不熟悉 StyleCop,有些设置一开始可能看起来很奇怪,但使用它已经两年了,现在我保留了所有选项,我们的团队对结果非常满意。

我还要说,如果您提供的库或框架使用FxCop可能比使用 StyleCop 更重要。

于 2008-12-02T14:21:55.680 回答
0

大多数大型开源项目都有自己的风格指南。例如,这里是Apache C 语言样式指南

作为开始,我建议您搜索您感兴趣的操作系统项目的常见问题解答并从那里获取。

无论如何,我相信会有很多人会很快让你知道你是否在很大程度上违反了任何现有的风格规则!;-)

注意所有的警告,通常他们试图告诉你一些有用的东西。不要像实用程序员所说的那样完成“巧合编程”(书摘)!

编辑:我没有意识到这是您自己的新操作系统项目。我的错。无论如何,我会对一些类似的已经存在的操作系统项目有所了解,看看他们是否有任何风格指南。当然,请查看史蒂夫·麦康奈尔 (Steve McConnell) 的书 Code Complete(亚马逊链接- 为漫游这些大厅的脚本 Kiddie 链接纳粹清理)。

我所说的警告和“巧合编程”仍然适用!(-:

HTH。

干杯,

于 2008-12-02T14:21:28.987 回答