C++头文件风波

不知道你有没有问过自己为什么会郁闷?原因也许很多,但多我来说,最郁闷的事情就是跟烂人合作。是的,虽然自己也很烂。CM么,总得搞一些七七八八的琐碎事情,程序员太烂了,提交的代码你实在是看不过眼,也就不得不说上两句。郁闷的是,你说一次需要改善之后,还需要再像祥林嫂那样做无数编重复。这不是因为你没有做文档,不是因为你没有写mailing list,不是因为你说的不清楚,该做的你都做了,可相同的错误还在不断的被重复。你不敢问“Who made the code dirty”,因为问这个问题就等于打开郁闷你的阀门,你对自己和别人的厌恶之情犹如滔滔江水会绵绵不绝。项目质量提高需要作很多工作,多到让一个小小的CM跟本左右不了的地步。上面的头儿说起来都是雷声大雨点小的对应办法,你报告打上去,那边敷衍一下了事,仅此而已。所以,从这一点上来看,Google黑板报的系列文章说的非常正确——一个公司的基因直接决定了它的命运!我敢断言M根本不能开发出来一个通用的移动设备平台软件,即便他很早就开始在这方面下了不少功夫。关于软件项目的进度管理,质量管理,源码版本控制一些问题,我已经思考了很久,虽然有些想法但是终于还是没有找到很好的解决良策,这个有空再谈。今天只说一件小事,就是C++的头文件!

C++和C语言是一脉相成的通用语言,可以说本质上几乎没有什么区别——使用这两种语言编程的对项目造成的最重大的影像恐怕只有设计。对于这一点,你可以认为它是C++自身的灵活性,但往往它却成为代码质量的头号大敌。谁也不会想到,一个“#include”语句会成为问题,在真正看到问题之前,我也不认为这个会是问题。什么问题?在C++的源代码中包含了c语言的头文件!比如一个cpp文件中竟然写了
#include <assert.h>
,就是这样。

C++标准库的文本写的很清楚,C++头文件应该包含下列3类

  • 旧的C标准库头文件(18个)
  • C++特有库的头文件(20个)
  • STL标准模板库的头文件(13个)

详情参看
http://cs.stmarys.ca/~porter/csc/ref/cpp_standlib.html
。也就是说,在C++源码中使用C语言标准库函数时,不应该包含C语言的头文件,而应该使用这个些没有”.h”后缀的C++头文件。于是以上面的<assert.h>为例,正确的使用方法是
#include <cassert>
这就够了。但仅仅是这个小问题——很多被我认为是举手之劳的问题,却是在我写了不下20封信件之后才能得到稍微的改善。然后,所谓的资深程序员的项目新人却还是会一遍一遍的重复这个错误。我曾问过一个兄弟,他告诉我教科书就是这么写这么用的。我很好奇是哪本教科书这么写的?他告诉我是大名鼎鼎的C++ Prime。恩,也许吧,我没有亲见,但是不能把全部责任怪到它头上,对这本巨著不能求全责备。
后来仔细思考一下,使用C++做开发的弊病至少有下面两条:

  1. 很多C++程序员是从c语言转型过来的,而恰恰因为c语言已经很好用了,他们会保留很多编写c语言程序的习惯。这些习惯不仅仅影响到CodingStyle,更会影响到程序员的思考方式,极端表现就是他们会使用一个面相对象语言写出结构化的代码来。关于用OO语言写出结构化程序这个事情,有着更加深刻复杂的原因,有空再谈。
  2. 仔细看过C++库源代码的人都知道,因为C++太灵活了,C++库对这门语言自身做了很多修修补补,比如smart point,就是一例。但是,C++仍然保持了很大程度的自由度,而这些自由相当一部分会被滥用。

这也是因为为什么在OO语言上面Java会后来居上的原因之一吧。

阐明事实看来是不难的,但是要让你的team都能有统一认识却是如此之难,困难到让我开始怀疑是不是我自己有病,在故作正义的挑战传统……管理!真是一个大问题!

2 thoughts on “C++头文件风波

  1. 这个问题还是要冷静一点看啦。对于标准或应该有标准的东西,都应该写到coding standard里去,然后定期review代码,或者文档。
    有时候没有办法,比如,接到一个很多年前写的c++代码,作者都不知道到哪里去了,在你的程序里用他的api,是C++的还好,对他的代码不需要做什么修改,如果是C的就麻烦了,把用到的类型检查一边,不符合mix规则的重写,用到的函数申明全加个extern “C”,重新编译才好。如果真着急了,对经理大吼一声“他娘的当初为什么不能用C实现?!!”,“给我一个C版本!!!”么?哈哈。

  2. 兄弟说的很对。但是,coding style guide不是没有阿。但我很怀疑有几个人看过这个玩意儿。项目很大,牵扯几十号人的动作,如果能够取得共识的话或许要花去很多很多时间。沟通是个大问题,我发现项目大了之后有差不多60%的时间花在跟人“说话”上。Mail,IM,电话轮番上,就这样也还是会问题百出。在不会导致订单减少的情况下,不要追求完美也许是一个折衷选择,总之,还是没有找到好的办法。

发表评论