一区二区久久-一区二区三区www-一区二区三区久久-一区二区三区久久精品-麻豆国产一区二区在线观看-麻豆国产视频

請注釋你那該死的代碼

  英文原文:Comment your damn code

  我站出來就是為了要說一句:

請注釋你那該死的代碼。

  每次我遇到一個程序員——有時是相當高水的——總發(fā)現(xiàn)他會認為:你并不需要給你的代碼加注釋。我要說,這就是胡說八道。我很長時間以來一直這么表達。問題是,讓事情改變要比你想象的難。雖然我們正處在努力編寫那些討厭的代碼、準備發(fā)布一些會令人驚嘆的新東西的緊要關(guān)頭,我們?nèi)匀粠缀踝⑨屗械臇|西。沒有任何借口不去做這些事情。每隔 3 到 7 行代碼,你就能看到有長篇的社論發(fā)表。有時,幾百行代碼里,你就能找到一個很好的笑話。

  錯誤的藏身之處

  看,一個是你想要的,一個是你實現(xiàn)的。你的 bug 就在這兩者之間。如果寫了注釋,你就是在告訴我你想要的。而你的代碼中告訴我你是如何去做的。程序的缺陷要么存在于你想要的想法中,要么,需求是對的,而你的代碼有問題。請幫助我,讓我知道究竟是哪個錯了。

  不要偷懶

  一個常見的反對聲音是:我聽說,注釋經(jīng)常會過期,因為代碼會經(jīng)常更新,而注釋不會。你不更新注釋嗎?你的同事也不?不要偷懶,不要養(yǎng)成一個讓人認為偷點兒懶無所謂的文化氛圍。告訴同事你是如何一絲不茍的注釋程序的,讓他們知道你也希望他們這樣去做。說不注釋是因為怕某人或某些地方在將來會造成你的錯誤,這只是在找借口。

  你是有經(jīng)驗的人

  人本無知,這很自然,但你是有經(jīng)驗的人。因此,你有義務(wù)教育那些需要學(xué)習(xí)的人。你的注釋會指導(dǎo)那些正在閱讀你的代碼的人。告訴他們?yōu)槭裁丛谶@里要用 Tuple 數(shù)據(jù)結(jié)構(gòu),而不是用其它的(更好的做法是附加一個 stack overflow 或 dotNETperls 上的鏈接 … 你完全可以做到這些,不是嗎?)你在這走了一個什么捷徑?如果不走捷徑你就不能按時發(fā)布,所以,告訴這些新手你遇到的特殊情況。否則的話,最終你的不好的代碼將會被四處拷貝,四處散播。看!你寫的爛代碼變成了公司的程序模板!完全沒有注釋!

  你會打字

  我的招聘過程有一部分是白板編程,一部分是鍵盤編程。所有好的程序員都是打字高手。就說你每分鐘能打出 40-60 詞。那請你告訴我,為什么在你機槍掃射似的編寫代碼時不加上注釋呢?當然,你可以花 30 秒時間告訴我,代碼寫的這樣一團糟是因為搞業(yè)務(wù)的那個家伙需要程序在本周發(fā)布而換回不菲的 7.5 萬美元。可是下個月呢?這些代碼不要了?封存到石頭里了?我知道這些代碼是在干什么。但請告訴我你的意圖

  你在一天天變老

  聽我說,我編程已經(jīng)很久了,也許早在你上中學(xué)之前。我仍然在編程,我仍然喜歡編程。有朝一日,你也會變的跟我一樣老。如果你到了像我一樣(那時我已經(jīng)沒有能力再教育你),那時,有太多的層,有太多的抽象,有太多的技術(shù)架構(gòu),你無法完全記住。你的注釋就能出來指導(dǎo)你。它們會告訴你,6 個月前,你是用這種方法、這種模式實現(xiàn)的,而且這樣做只是為了炫耀。如果你是一個真正優(yōu)秀——并且仍然在做編程的程序員——你會認識到,這些代碼寫的很爛,你現(xiàn)在需要以不同的方式重新實現(xiàn)它。而你仍然有你的注釋來讓你回憶起當時的想法和為什么這樣做。

  所以,請注釋你那該死的代碼。

it知識庫請注釋你那該死的代碼,轉(zhuǎn)載需保留來源!

鄭重聲明:本文版權(quán)歸原作者所有,轉(zhuǎn)載文章僅為傳播更多信息之目的,如作者信息標記有誤,請第一時間聯(lián)系我們修改或刪除,多謝。

主站蜘蛛池模板: 伊人激情久久综合中文字幕 | 精品国产不卡一区二区三区 | 青青草久久伊人 | 精品日韩欧美一区二区三区在线播放 | 国产大陆亚洲精品国产 | 国产综合久久久久影院 | 国产精彩视频在线观看 | 起碰97| 国产乱了| 依人在线免费视频 | 青青草国产免费国产是公开 | 精品国产福利片在线观看 | 999国内精品永久免费视频 | 国产成人精品亚洲日本在线 | 日产欧产va高清 | 欧美人与zoxxxx视频 | 久久久久久久91精品免费观看 | 国产精品第二页在线播放 | 美国一区二区三区 | 国产大臿蕉香蕉大视频 | a加勒比一本东京 | 国产精品夜色一区二区三区 | 色视频网站大全免费 | 国产美女一级片 | 韩国女主播一区二区视频 | 成人精品区| 亚洲天堂岛国片 | 伊人婷婷涩六月丁香七月 | 日本不卡一区二区三区四区 | 成年人免费在线视频观看 | 亚洲欧美日韩国产一区二区三区精品 | 欧美成人伊人十综合色 | 国产精品香蕉在线一区 | 亚洲天堂成人在线观看 | 在线视频免费国产成人 | 久久婷婷国产精品香蕉 | 中文字幕日韩三级 | 久草一级片 | 精品一区二区三区视频在线观看免 | 国产福利91精品 | 国产精品资源网站在线观看 |