IT评估编码质量 - 我们如何知道什么是好的？

Question

来自IT背景,我参与过软件项目,但我不是程序员.我最大的挑战之一是拥有大量的IT经验,人们常常转向我来管理包含软件开发的项目.这些项目通常是外包的,并且没有全职架构师或PM的预算,这使我能够评估正在执行的工作.

在过去,我已经设法通过这个,我(有充分理由)对接受这些责任感到不安.

我的问题是,从技术经验而非编程的角度来看,除了确定编码是否有效之外,我如何评估编码是否写得好？是否有方法,技巧,交易技巧,旗帜,标志,任何可以说的东西 - 嘿这是垃圾还是嘿,这真是太棒了？

Answer 1

好问题.应该得到一些好的回应.

1. 代码清洁度(缩进,文件组织,文件夹结构)
2. 评论很好(不只是内联评论,而是说明它们是什么的变量,说出它们做什么的函数等等)
3. 小的可理解的函数/方法(没有疯狂的300行方法,如果逻辑遍及整个地方就可以执行各种各样的事情)
4. 遵循SOLID原则
5. 单元测试代码的大小和质量是否与项目的代码库相似
6. 接口代码是否与业务逻辑代码分开,而业务逻辑代码又应与基础结构访问代码(电子邮件,数据库,Web服务,文件系统等)分开
7. 性能分析工具如何看待代码(NDepend,NDoc,NCover等)

这还有很多......但这会让你开始.

Answer 2

代码有2个主要受众群体:

• 使用它的人
• 发展它的人

所以你需要进行2个简单的测试:

• 运行代码.你能做到它应该做的工作吗？
• 阅读代码.你能理解开发者的一般意图吗？

如果您对这两个问题都回答"是",那就是很棒的代码.

阅读代码时,不要担心您不是程序员.如果代码写得很好/有文档记录,即使是非程序员也应该能够看到很多想要实现的目标.

顺便问一下:好问题!我希望更多的非程序员关心代码质量.

Answer 3

如何评价代码是否写得好

有多种方法/指标来定义“好”或“好”，例如：

• 准时交货
• 交货迅速
• 交付后无任何缺陷
• 易于安装
• 有据可查
• 跑得快
• 使用廉价的硬件
• 使用廉价软件
• 没花太多钱写
• 易于管理
• 便于使用
• 易于更改（即添加新功能）
• 易于移植到新硬件
• ...ETC...

其中，程序员倾向于看重“易于更改”：因为，他们的工作是更改现有软件。