有意義的命名

在編程過程中饭庞,命名隨處可見。我們?cè)诰幊踢^程中轧膘,應(yīng)使命名名副其實(shí)钞螟。這件事很重要也很嚴(yán)肅,選個(gè)好的名字要花很多時(shí)間谎碍,但是我們卻能省下更多的時(shí)間鳞滨。而且我們一旦發(fā)現(xiàn)更好的名字就應(yīng)換掉舊的。
我們?cè)诿麜r(shí)蟆淀,名稱就應(yīng)當(dāng)答復(fù)了大多數(shù)問題拯啦。它應(yīng)該告訴你,它為什么存在熔任,它做什么事褒链,應(yīng)該怎么用。

  • 有意義的區(qū)分
    我們?cè)诿麜r(shí)應(yīng)依義命名疑苔。萬萬不能使用數(shù)字系列命名(a1碱蒙,a2 ,···,aN)赛惩,這樣的名稱純屬誤導(dǎo)——完全沒有提供正確信息哀墓;沒有提供導(dǎo)向作者意圖的線索。
  • 使用讀得出來的名稱
  • 使用可搜索的名稱
  • 避免使用編碼
  • 避免思維映射
    不應(yīng)當(dāng)讓讀者把你的名稱翻譯成他們熟知的名稱
    -類名
    類名和對(duì)象名應(yīng)該是名詞或名詞短語
  • 方法名
    方法名應(yīng)當(dāng)是動(dòng)詞或動(dòng)詞短語
  • 每個(gè)概念對(duì)應(yīng)一個(gè)詞
    給每個(gè)抽象概念選一個(gè)詞喷兼,并且一以貫之篮绰。
  • 別用雙關(guān)語
  • 使用解決方案領(lǐng)域名稱
    只有程序員才會(huì)讀你的代碼。所以盡管使用那些計(jì)算機(jī)科學(xué)領(lǐng)域術(shù)語季惯、算法名吠各、模式名、數(shù)學(xué)術(shù)語吧勉抓。
    -使用源自所涉問題領(lǐng)域的名稱
    如果不能用程序員熟悉的術(shù)語來命名就采取從所涉問題領(lǐng)域來的名稱贾漏。
  • 添加有意義的語境
    很少有名稱是能自我說明的。所以我們需要用良好命名的類藕筋、函數(shù)或名名稱空間來放置名稱纵散,給讀者提供語境。如果沒有這么做隐圾,可以給名稱添加前綴伍掀。
    注意:不要添加沒用的語境,比如給所有類添加同一個(gè)前綴暇藏。只要語義足夠清楚蜜笤,短名稱比長(zhǎng)名稱要好。
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末盐碱,一起剝皮案震驚了整個(gè)濱河市把兔,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌瓮顽,老刑警劉巖垛贤,帶你破解...
    沈念sama閱讀 217,907評(píng)論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異趣倾,居然都是意外死亡聘惦,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,987評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門儒恋,熙熙樓的掌柜王于貴愁眉苦臉地迎上來善绎,“玉大人,你說我怎么就攤上這事诫尽≠鹘矗” “怎么了?”我有些...
    開封第一講書人閱讀 164,298評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵牧嫉,是天一觀的道長(zhǎng)剂跟。 經(jīng)常有香客問我减途,道長(zhǎng),這世上最難降的妖魔是什么曹洽? 我笑而不...
    開封第一講書人閱讀 58,586評(píng)論 1 293
  • 正文 為了忘掉前任鳍置,我火速辦了婚禮,結(jié)果婚禮上送淆,老公的妹妹穿的比我還像新娘税产。我一直安慰自己,他們只是感情好偷崩,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,633評(píng)論 6 392
  • 文/花漫 我一把揭開白布辟拷。 她就那樣靜靜地躺著,像睡著了一般阐斜。 火紅的嫁衣襯著肌膚如雪衫冻。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,488評(píng)論 1 302
  • 那天谒出,我揣著相機(jī)與錄音隅俘,去河邊找鬼。 笑死到推,一個(gè)胖子當(dāng)著我的面吹牛考赛,可吹牛的內(nèi)容都是我干的惕澎。 我是一名探鬼主播莉测,決...
    沈念sama閱讀 40,275評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼唧喉!你這毒婦竟也來了捣卤?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,176評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤八孝,失蹤者是張志新(化名)和其女友劉穎董朝,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體干跛,經(jīng)...
    沈念sama閱讀 45,619評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡子姜,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,819評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了楼入。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片哥捕。...
    茶點(diǎn)故事閱讀 39,932評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖嘉熊,靈堂內(nèi)的尸體忽然破棺而出遥赚,到底是詐尸還是另有隱情,我是刑警寧澤阐肤,帶...
    沈念sama閱讀 35,655評(píng)論 5 346
  • 正文 年R本政府宣布凫佛,位于F島的核電站讲坎,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏愧薛。R本人自食惡果不足惜晨炕,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,265評(píng)論 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望厚满。 院中可真熱鬧府瞄,春花似錦、人聲如沸碘箍。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,871評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽丰榴。三九已至货邓,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間四濒,已是汗流浹背换况。 一陣腳步聲響...
    開封第一講書人閱讀 32,994評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留盗蟆,地道東北人戈二。 一個(gè)月前我還...
    沈念sama閱讀 48,095評(píng)論 3 370
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像喳资,于是被迫代替她去往敵國(guó)和親觉吭。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,884評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容

  • 本章仆邓,作為整潔代碼的頭一步鲜滩,致力于規(guī)范命名規(guī)則。 圖片來自<Clean Code> 所謂名不正則言不順节值,命名的好徙硅,...
    徐朝_尼克徐閱讀 699評(píng)論 0 1
  • 名副其實(shí) 選個(gè)好名字要花時(shí)間,但省下來的時(shí)間比花掉的多搞疗。 一旦發(fā)現(xiàn)有更好的名稱嗓蘑,就換掉舊的。 好的名稱會(huì)告訴你:它...
    lsh的學(xué)習(xí)筆記閱讀 218評(píng)論 0 0
  • 名副其實(shí): 變量、函數(shù)或類的名稱就能夠說明為什么它存在扳埂,做什么事业簿,怎么用,如果需要注釋來補(bǔ)充阳懂,就不算名副其實(shí): 避...
    樹下老男孩閱讀 850評(píng)論 0 3
  • 2.2 名副其實(shí) 在代碼中體現(xiàn)上下文的語境梅尤,能夠知道這段代碼想干什么柜思; 2.3 避免誤導(dǎo) 避免留下隱藏代碼本意的線...
    oliversmallgan閱讀 307評(píng)論 0 0
  • 凈空法師:惡念太多相貌就不好看 佛在經(jīng)論上告訴我們赡盘,一切眾生的相,是業(yè)力變現(xiàn)的缰揪。相的好丑陨享,就是善惡業(yè)的現(xiàn)前。俗話常...
    磬思candy閱讀 728評(píng)論 0 2