在尝试实现我想要的特性之后,我一直致力于改进现有的库,使其更易于维护,并且发现代码很难修改。
这个库是一个名为node.js的格伦特-托勒-吉辛特插件,我的实现是在一个名为grunt jshint-bfs的回购程序中。
我运行了一个名为柏拉图的代码分析工具,该工具生成一个源代码分析报告,其中包括度量行--代码行总数/平均行、可维护性和估计错误--以便为了代码质量的目的比较代码库。
我遇到的麻烦是比较这两个项目之间的估计错误,因为其中一个有两个文件,另一个有更多的文件,这似乎会增加对错误的暴露,还是我看错了?
这里有一个指向我的回购报告和grunt cont肋骨-jshint报告的链接,以供比较。
发布于 2013-04-18 23:30:12
我觉得你看错了。在阅读这两份报告的基础上,柏拉图似乎从代码的长度和复杂性中推断出了一个估计的错误值。较长、更复杂的函数往往具有较高的估计误差值。不幸的是,柏拉图没有为其算法和方法提供任何文档(我可以找到),除了源代码本身之外,还有几处提到了它使用的复杂性和皮棉库。这告诉我,它不是一个严肃的工具,尽管它的报告看上去很棒。
跨多个文件分配函数(而不改变函数本身)对总体错误估计没有任何影响。然而,柏拉图似乎倾向于更短的源文件,因此,通过将函数转移到更多的文件,您将使工具更快乐。这不是这么做的充分理由,国际海事组织。同样不幸的是,柏拉图为它所生成的各种度量标准提供的项目范围的总数如此之少。源文件的划分是任意的,但是所有文件的总数才是最重要的。
作为比较,这是柏拉图的关于jquery的报告。它显示了许多文件的估计错误值远远超过1。这是否意味着jquery (现在在相当大一部分的web页面上使用)有那么多错误?我怀疑。由于Jquery的大量使用,它也进行了大量的测试,而且可能几乎没有bug。
我认为你应该对柏拉图的结果略加评价。它使用了一些静态分析工具(而不是特别复杂的工具,IMO)和批量测量,这些都不是编码风格和工程质量的良好度量标准。相反,我建议您相信您对代码质量的直觉,并发展您对代码气味的感觉[维基百科,杰夫·阿特伍德]。
最后,请记住,虽然降低复杂性是一个有价值的目标,但有些代码只是需要复杂。人为地稀释自然复杂性(可能是通过许多子程序层)可能会使其他程序员无法阅读。写一篇好的评论,并相信你的同事会处理一些困难的事情。
https://softwareengineering.stackexchange.com/questions/195383
复制相似问题