详细设计在软件开发中的作用

 

我们一直在为软件工程的标准化管理与软件开发的标准化而努力。多年过去了，让人越来越深刻的感受到文档在实际应用中的作用。因此就希望能作一些相关内容的总结，发现这样的总结很有意义、它给我们带来了更系统的思考。

其实软件工程管理，早已有了比较成熟的方法，我们尝试着参考了日本、美国等发达国家的软件工程管理方法，并针对中国国内具体情况作出了一些改动，最终形成了符合国情、符合国际标准的《软件开发标准文档》。当然这个文档还有很多的方面有待完善，希望各位同仁，我们一起为中国的软件标准化而共同努力。软件开发的过程中涉及到的文档有很多，他们有的是为工程管理服务的、有的是为项目质量服务的、有的是为把控工期服务的等等，今天我们重点谈《详细设计》文档。

对于整个开发的过程中，详细设计是一个难点，说它是难点，有很多方面：

首先，编写详细设计很费时间，如果写了详细设计很可能就不能保证代码开发的时间了，因此很多公司就会放弃详细设计文档的编写工作；

其次，我就算花大力气、认真的写了详细设计文档，它又能给我带来什么好处呢？只能是给我带来累赘，详细设计文档写完了，这时需求变更了，我们还要先变更文档，然后再变更程序。而现实问题是这个变更要在明天上班前对应完成！让我来尝试地回答这个问题。在一个团队中比如有8名研发人员、2名测试人员、1名项目经理，在这种体制下（当然，如果需要我们可能还会有其它人员，如：QA、配置管理员等等），我们应再加入一个文档的维护人员，这个人应对技术与业务比较了解，而不是单纯的文档编写人员。第一版的详细设计文档是程序员写的，以后的所有的文档均是这个文档维护人员写的。我们提高项目的人员成本，那么值不值呢？往下看！详细设计在现实应用中的实际意义。 1、详细设计的编写过程本身就是一个模拟开发的思考过程，通过这种思考，经验丰富的程序员可以把大部分的问题都能挖掘出来，而不是等干到的时候，才发现有一些问题。这很重要，它会直接影响项目整体工期的评估、直接影响项目开发的进展的顺利程度、减少开发的迭代的发生、减少开发时间、降低开发成本。这也是为什么在详细设计完成之前不能进行实质性的开发的一个因素；2、给协同开发团队一个标准，能够完整的展望出整个项目；3、使开发与测试可以有共同的标准。详细设计文档出来后，开发人员可以按着详细设计文档写代码，与此同时，测试人员可以根据详细设计文档写测试用例，开发与测试使用相同的“源”，从提高项目的质量；4、一个项目只有有了详细设计文档才能使软件能够达到“他人可维护”的境界。彻底解决软件对具体开发人员的依赖性；

再次，是不是所有的项目都应有完整的详细设计文档？根据不同项目的具体情况而定。主要看这个项目对上文中所说的详细设计的4种意义是否必要，如果必要则应写详细设计文档，而且，可能只是对某些意义有特别要求，这样我们的详细设计文档就可以有针对性的进行编写；

最后，详细设计文档有没有标准，怎么写才叫合格的详细设计文档？没有统一的标准，根据不同的项目特点、具体要求会有一些出入。

这是我的一些简单的理解，同时，也请大家能多关注我的博客： http://blog.csdn.net/home_dear。

作者还有过另一篇文章：《如何书写符合标准的数据字典与详细设计文档 》http://blog.csdn.net/home_dear/article/details/7219186。