如何命名

建議學(xué)習(xí)時(shí)長(zhǎng): 30分鐘
學(xué)習(xí)方式:了解

學(xué)習(xí)目標(biāo)

  • 不起特別差的名字

詳細(xì)介紹

There are only two hard things in Computer Science: cache invalidation and naming things.-- Phil Karlton

命名的原則

1 使用名副其實(shí)(Intention-Revealing)的名字

  • 不要定義無(wú)意義的名字
  • 不要使用magic numbers

2 避免傳達(dá)錯(cuò)誤的意思

  • 避免使用有歧義的名字,比如與其他已存的命名系統(tǒng)相同或相似的名字(比如hp, aix, sco)
  • 避免使用與語(yǔ)言特性相關(guān)的詞,比如曾我,accountList, 如果它真的是一個(gè)某些語(yǔ)言中的List結(jié)構(gòu)還好扮匠,如果不是砰琢,最好使用bunchOfAccounts或者直接accounts更好厦酬。
  • 避免在不同的地方使用只有微妙區(qū)別的命名融撞。

3 在命名和命名之間使用有意義的區(qū)別

4 使用語(yǔ)音可讀的命名

5 使用容易搜索的命名

6 避免發(fā)明新的編碼方式來(lái)命名

7 避免腦補(bǔ)

8 不要使用可愛(ài)的命名

9 同一個(gè)概念使用同一個(gè)單詞

10 避免使用雙關(guān)語(yǔ)

11 使用程序員熟悉的專有名詞

12 使用描述問(wèn)題的命名

13 添加有意義的上下文

14 不要添加無(wú)意義的上下文

詳細(xì)見(jiàn)命名的藝術(shù)(clean code閱讀筆記之一)勉耀。

CSS 的常用命名

狀態(tài)

  • collapsed 收攏的
  • expanded 展開的
  • current 當(dāng)前
  • selected 選中的
  • active 活躍的
  • enabled 可用
  • disabled 不可用

布局

  • 頭部 header
  • 尾部 footer
  • 主欄 main
  • 側(cè)欄 side
  • 盒容器 wrap
  • 條目 item指煎。一般和模塊名一起用,如 list-item便斥, news-item至壤。

模塊

  • 導(dǎo)航 nav
  • 子導(dǎo)航 subnav
  • 面包屑 crumb
  • 菜單 menu
  • 選項(xiàng)卡 tab
  • 標(biāo)題 head/title
  • 列表 list
  • 內(nèi)容 content
  • 表格 table
  • 表單 form
  • 熱點(diǎn) hot
  • 排行 top
  • 登錄 login
  • 標(biāo)志 log
  • 搜索 search
  • 幻燈 slide
  • 提示 tip
  • 幫助 help
  • 新聞 news
  • 下載 download
  • 注冊(cè) regist
  • 投票 vote
  • 版權(quán) copyright
  • 結(jié)果 result
  • 按鈕 button
  • 輸入 input
  • 個(gè)人中心
    • 用戶狀態(tài)(關(guān)注數(shù),喜歡數(shù)) user-status
    • 用戶頭像 avatar
    • 徽章 badge

推薦閱讀

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末像街,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子晋渺,更是在濱河造成了極大的恐慌镰绎,老刑警劉巖,帶你破解...
    沈念sama閱讀 219,039評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件些举,死亡現(xiàn)場(chǎng)離奇詭異跟狱,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)户魏,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,426評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門驶臊,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人叼丑,你說(shuō)我怎么就攤上這事关翎。” “怎么了鸠信?”我有些...
    開封第一講書人閱讀 165,417評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵纵寝,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我星立,道長(zhǎng)爽茴,這世上最難降的妖魔是什么葬凳? 我笑而不...
    開封第一講書人閱讀 58,868評(píng)論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮室奏,結(jié)果婚禮上火焰,老公的妹妹穿的比我還像新娘。我一直安慰自己胧沫,他們只是感情好昌简,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,892評(píng)論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著绒怨,像睡著了一般纯赎。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上南蹂,一...
    開封第一講書人閱讀 51,692評(píng)論 1 305
  • 那天犬金,我揣著相機(jī)與錄音,去河邊找鬼碎紊。 笑死佑附,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的仗考。 我是一名探鬼主播音同,決...
    沈念sama閱讀 40,416評(píng)論 3 419
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼秃嗜!你這毒婦竟也來(lái)了权均?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,326評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤锅锨,失蹤者是張志新(化名)和其女友劉穎叽赊,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體必搞,經(jīng)...
    沈念sama閱讀 45,782評(píng)論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡必指,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,957評(píng)論 3 337
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了恕洲。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片塔橡。...
    茶點(diǎn)故事閱讀 40,102評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖霜第,靈堂內(nèi)的尸體忽然破棺而出葛家,到底是詐尸還是另有隱情,我是刑警寧澤泌类,帶...
    沈念sama閱讀 35,790評(píng)論 5 346
  • 正文 年R本政府宣布癞谒,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏弹砚。R本人自食惡果不足惜双仍,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,442評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望迅栅。 院中可真熱鬧殊校,春花似錦、人聲如沸读存。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,996評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)让簿。三九已至,卻和暖如春秀睛,著一層夾襖步出監(jiān)牢的瞬間尔当,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,113評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工蹂安, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留椭迎,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,332評(píng)論 3 373
  • 正文 我出身青樓田盈,卻偏偏與公主長(zhǎng)得像畜号,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子允瞧,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,044評(píng)論 2 355

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

  • 編程中離不開命名述暂。命名是指給變量痹升、方法或函數(shù)、類畦韭、文件起名字疼蛾。命名的最基本要求是,要遵守特定編程語(yǔ)言對(duì)命名的要求艺配。...
    剛剛悟道閱讀 1,266評(píng)論 1 11
  • 駝峰式命名法(Camel-Case)是電腦程式編寫時(shí)的一套命名規(guī)則(慣例)妒挎。 駝峰式命名法就是當(dāng)變量名或函式名是由...
    藝龍閱讀 1,046評(píng)論 0 1
  • 給變量起名字時(shí)绳锅,必須符合一定的規(guī)則 優(yōu)秀攻城師的習(xí)慣: 1、變量名由多單詞組成時(shí)酝掩,第一個(gè)單詞的首字母小寫鳞芙,其后單詞...
    吳迪好閱讀 322評(píng)論 0 0
  • Android 自定義View的各種姿勢(shì)1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,169評(píng)論 25 707
  • 你有沒(méi)有這種感覺(jué):對(duì)一個(gè)事物鞠评,熟悉得不能再熟悉,但是具體要你闡述一下壕鹉,啞口無(wú)言剃幌。 比如,挪威的森林晾浴。 怕是每個(gè)人都...
    尚小迪閱讀 3,451評(píng)論 1 4