有意义的命名

前言

    在开发过程中,给变量以及方法提供一个有意义的命名至关重要。有意义的命名对代码可读性的提升有很大帮助。一个项目开发完后甚至在开发过程中,有可能由于项目的部分参与者工作变动或者项目人手不够导致有新的开发者参与进来,这些新加入的开发者开始的时候并不熟悉整个项目,在他们熟悉代码的过程中有意义的命名可以极大的提升项目的开发效率,而没有意义的命名会严重延缓项目进度。

 那么,如何实现有意义的命名呢?

有意义的命名

在给变量或者函数命名的时候,名字应该能够准确表达真实意思,比如我们要声明一个变量来表示时间,

    int t;

    这里t并不能清晰的表明是时间,如果我们想要增强代码的可读性,我们可能就需要增加注释说明了。在代码中适当的注释是必要的,但是有时候我们完全可以避免不必要的注释,我们可以使用如下声明避免增加注释而能准确表示变量的意思,

    int time;

    变量名长一点没有关系,毕竟变量名的长短又不会影响内存的占用。

    在命名的时候,还是要努力提高即几的知识水平(smile),确保用英文单词的时候词要大意。单词用错很有可能不能快速且正确的传递代码的意思。

    我们应该避免一些容易引起误导的命名,比如我们现在要声明一个用于存储一组电话号码的变量, 可能我们就会很轻易的命名为phoneNoList。除非我们真的将变量声明为List类型,否则我们还是不要如此命名,因为这样命名会容易让其他的开发者认为是List类型,但实际操作的时候却不是按照List类型来操作从而造成困惑。另外我们有时候要区分单复数,比如我们用一个变量来记录众多客户的信息,应该用

    List customerInfos;

    来声明,而不是用

    List customerInfo;

    我们在命名的时候,在必要的时候尽量添加一些有意义的语境,比如在存储外国人的名字时,我们不要用诸如name1,name2等这样带编号的名字来命名,我们应该使用如firstName,lastName等这样带语境的名字来命名。但是忌讳添加没有意义的语境,比如现在开发一个“拯救地球”(Save The Earth)的应用,我们不能再所有名字前面都加上STE这样的语境,如果真这么做的话,用IDE开发的时候指定会崩溃的

易于检索的命名

    在命名函数或变量的时候,尽量不要用很常用的名字来命名。在一个大的项目中,如果用太常用的名字来命名的话,在检索变量或函数的时候很有可能给我们展示出一堆信息,这样会导致我们需要花费一定的时间去筛选出我们需要的信息。在用IDE编码的时候也能够快速给出有效的提示。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,919评论 6 502
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,567评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,316评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,294评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,318评论 6 390
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,245评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,120评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,964评论 0 275
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,376评论 1 313
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,592评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,764评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,460评论 5 344
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,070评论 3 327
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,697评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,846评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,819评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,665评论 2 354

推荐阅读更多精彩内容

  • 本章,作为整洁代码的头一步,致力于规范命名规则。 图片来自<Clean Code> 所谓名不正则言不顺,命名的好,...
    徐朝_尼克徐阅读 699评论 0 1
  • 第二章主要讲述了,如何给变量、函数、参数、类、包等创建一个有意义的名字。 我觉得这一章的核心思想就一句话:在尽可能...
    过客又见过客阅读 251评论 0 0
  • 名副其实 变量名应该告诉你:他为什么会存在,他做什么事,他应该怎么用 如果名称需要注释来补充,那就不算名副其实 p...
    denuth阅读 248评论 3 0
  • 中国人结婚后叫自己的另一半----媳妇(婦),为什么呢?从文字上分析:媳字是由女、息二字合成,意即女子成为媳妇后在...
    如歌7阅读 290评论 0 1
  • 定义 优势 劣势 索引结构 适合建立索引的情况 不适合建立索引的情况 索引 1 索引添加 2.查询索引 3.删除索...
    笑Skr人啊阅读 267评论 0 3