|
马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。
您需要 登录 才可以下载或查看,没有帐号?立即注册
x
聪明的你,显然已经逐渐的开悟了,慢慢的理解了编程的概念,那么祝贺你,你已经迈出了成功的第一步。
我站出来就是为了要说一句:
每次我碰到一个法式员——有时是相当高程度的——总发明他会以为:你其实不需求给你的代码加正文。我要说,这就是胡言乱语。我很长工夫以来一向这么表 达。成绩是,让工作改动要比你想象的难。固然咱们正处在勉力编写那些厌恶的代码、筹办宣布一些会使人赞叹的新器材的生死关头,咱们依然几近正文一切的东 西。没有任何托言不去做这些工作。每隔3到7行代码,你就可以看到有长篇的社论宣布。有时,几百行代码里,你就可以找到一个很好的笑话。
毛病的藏身的地方
看,一个是你想要的,一个是你完成的。你的bug就在这二者之间。假如写了正文,你就是在告知我你想要的。而你的代码中告知我你是若何去做的。法式的缺点要末存在于你想要的设法中,要末,需求是对的,而你的代码有成绩。请匡助我,让我晓得事实是哪一个错了。
不要偷懒
一个罕见的否决声响是:我传闻,正文常常会过时,由于代码会常常更新,而正文不会。你不更新正文吗?你的同事也不?不要偷懒,不要养成一个让人以为 偷点儿懒无所谓的文明气氛。告知同事你是若何一丝不苟的正文法式的,让他们晓得你也但愿他们如许去做。说不正文是由于怕或人或某些中央在未来会形成你的错 误,这只是在找托言。
你是有经历的人
人本蒙昧,这很天然,但你是有经历的人。因而,你有责任教导那些需求进修的人。你的正文会指点那些正在浏览你的代码的人。告知他们为何在这里要用 Tuple数据布局,而不是用其它的(更好的做法是附加一个stack overflow或dotnetperls上的链接 … 你完整可以做到这些,不是吗?)你在这走了一个甚么捷径?假如不走捷径你就不克不及按时宣布,所以,告知这些老手你碰到的特别情形。不然的话,终究你的欠好的 代码将会被四周拷贝,四周散布。看!你写的烂代码酿成了公司的法式模板!完整没有正文!
你会打字
我的雇用进程有一局部是白板编程,一局部是键盘编程。一切好的法式员都是打字高手。就说你每分钟能打出40-60词。那请你告知我,为何在你机枪 扫射似的编写代码时不加上正文呢?固然,你可以花30秒工夫告知我,代码写的如许一团糟是由于弄营业的谁人家伙需求法式在本周宣布而换回不菲的7.5万美 元。可是下个月呢?这些代码不要了?封存到石头里了?我晓得这些代码是在干甚么。但请告知我你的意图。
你在一每天变老
听我说,我编程已好久了,或许早在你上中学之前。我依然在编程,我依然喜好编程。有朝一日,你也会变的跟我一样老。假如你到了像我一样(那时我已 经没有才能再教导你),那时,有太多的层,有太多的笼统,有太多的手艺架构,你没法完整记住。你的正文就可以出来指点你。它们会告知你,6个月前,你是用这 种办法、这类形式完成的,并且如许做只是为了夸耀。假如你是一个真正优异——而且依然在做编程的法式员——你会熟悉到,这些代码写的很烂,你如今需求以不 同的体例从头完成它。而你依然有你的正文来让你回想起事先的设法和为何如许做。
所以,请正文你那活该的代码。
[本文英文原文链接:Comment your damn code ]
在学习PHP这六个月里,每看到一个优秀的php脚本,就会兴奋的手舞足蹈,嘴里还不停的说:太酷了,太酷了。呵呵,很幼稚吧,但这可能就是兴趣。 |
|