网站开发申请微信支付,烟台网站开发,网站建设实践报告绪论,大理州建设局网站门户网事情是这样的#xff0c;有人离职#xff0c;公司调我补缺。那个系统一直有个工程师在维护#xff0c;参与该系统的新人来了又走#xff0c;他始终泰然自若。刚过去一个礼拜#xff0c;我就心下窃吼#xff1a;“坑爹啊!”#xff0c;也彻底体会到什么叫---绝对的权威、… 事情是这样的有人离职公司调我补缺。那个系统一直有个工程师在维护参与该系统的新人来了又走他始终泰然自若。刚过去一个礼拜我就心下窃吼“坑爹啊!”也彻底体会到什么叫---绝对的权威、专家。该软件系统是公司发家的支柱产品涉及十几个国家x七八个机型700 个文件 (C语言所有.c .h档)十几万行代码尽两百个跨模块全局变量编译条件成百上千......(好吧这是找借口、吐槽的节奏)。尽管有名义上的交接和几次和声细语的密切指导。但真正独立展开工作时许多小功能增删改我都要折腾个好几天才能厘清代码调用关系、算法原 理然后找到修改点谨慎细微龟速前行。进度追踪的人有的时候也催毛了直接请专家大师出手咔咔咔不到半天就搞定了。当然前期我当然尽量的”不耻上 问”但人嘛总是有遇到被激发“骨气”的时候。这几天好不容易搞好一个全新的功能模块把代码推送给他合并编译。不曾想出现了让我泣血的一幕。我眼睁睁地、眼睁睁看着她把我辛苦敲入的代码注释/**/通通换成//一份精美的代码顿时成渣。我询问缘由她的回答是: 当代码里面充满注释符号/**/时她想要用/**/注释整段代码时就会很麻烦。我理解了因为/**/不支持嵌套。比如下面这样的语句是编译不过的。1 /*
2 a b c; /* 注释 */
3 */
4我的手抬了抬终究作罢。虽然我感觉到尊严被践踏心爱的作品被蹂躏但我还是开始反思。许多软件规范、专家、有经验的工程都建议或要求注释代码最好使用/**/他们的理由大略如下:1//进行注释不够严谨例如:1 // 注释语句 ??/
2a b c;此时a b c在一些编译器不会被执行。因为??/会被编译器当作 \变成C语言的换行符。于是这段代码等同于// 注释语句 a b c ;就会被注释掉。大家有兴趣的不妨去搜索一下C语言 三字母词当然哪怕没有??/ 自己打盹碰到delete键也是会屏蔽掉ab c的。2//的注释来源于C 有些早期的C编译器对这种注释是不支持的。代码要做到全平台兼容这点是必须要考虑的。因此老外定义的C语言软件规范无论是MISRA还是CMMI一般都要求所有代码注释必须使用/**/。君不见那uCOS的最新版本源码所有注释都是/**/。君不见那STM32的最新固件库洋洋洒洒几十个文件通篇皆没有用到//。正是基于这样的理由让我的心中充满了愠怒。但我仍然没有当场反驳她因为这些理由还有些苍白无力。1、当时那个什么三字母词“??x”到底是什么我已经忘了没法立刻做试验编译给她看而且时候我里面做了编译实验得到的是filename.c, line xxxx: Warning: #2532-D: support for trigraphs is disabled xx代码语句xx // ??/trigraph金山词霸--- [traigra:f]三字母词看吧编译器都警告了默认是不支持的。2、而且所谓的//是C 的早期的c编译器不支持。这点谁鸟啊我们只要现在只用最新版本的编译器所以我还要继续思考我要维护这个传统为自己代言......我开始思考还有什么强劲有力的理由来支持我恪守的真理C语言代码注释必须使用/**/。3我的三大理解倘若所有代码里面的注释用到/**/时当你要注释掉这段代码时如果不想忍受编译器的嵌套报警又懒得把一个个/**/换成//的话。那么你还有如下选择。1) 慎重思考下是否删光这段代码如果还有些不舍那就先备份(git推送)一下再删光。因此理由一使用/**/注释代码会使软件系统减少冗余的僵尸代码鼓励程序员的程序备份行为。2) 或者用编译条件圈起来如下。1#if (XXX_ENABLE)
2 func(a, b, c); /* 注释 */
3 ...... /* 注释 */
4#endif那么你不得不考虑xxx的命名如何更加一目了然再写点注释什么的表明对这段代码“弃而不舍”的缘由。因此理由二使用/**/注释代码会鼓励程序员删除代码时三思而后行并且注明舍弃的理由。3) 当然偷懒的人还是会用 #if 0 #endif圈起来 如下1#if 0
2 func(a, b, c); /* 注释 */
3 ...... /* 注释 */
4#endif而且不会写任何注释表明删除的理由。然而“#if 0”是一个如此的醒目很容易成为一个评估软件质量、工作绩效的搜索关键词。从管理的角度这个是可以量化的。因此理由三: 使用/**/注释代码有利于公司进行软件质量控管对程序员绩效考核。这三个理由足够说服你么声明本文于网络整理版权归原作者所有如来源信息有误或侵犯权益请联系我们删除或授权事宜。
