精华内容
下载资源
问答
  • 变量命名

    2017-04-29 08:53:09
    变量命名今天抽时间把很久之前买的一本书《代码大全》中第十一章:(The Power of Variable Name)变量名的力量大概的看了一下,然后又去网上找了一份编码规范的文档大致的浏览了一下,看的时候觉得自己写代码的时候...

    今天抽时间把很久之前买的一本书《代码大全》中第十一章:(The Power of Variable Name)变量名的力量大概的看了一下,然后又去网上找了一份编码规范的文档大致的浏览了一下,看的时候觉得自己写代码的时候关于变量命名等问题确实存在很大的问题,也难怪这几天写代码诸多不顺。
    总结一下吧

    选择好变量名注意事项

    • 变量名不要太长也不要太短,要能准确的表达出变量所代表的含义,也要能清晰的一眼看出来,如果变量名太长的话,读起来往往觉得很费力,一般来说,变量的名称在10到16个字符较为合适,
    • 作用域对变量的命名同样有很大的影响,当你在程序中使用 i 作为变量的时候,对于这个变量的作用域应该心知肚明,i 或许在你的代码里只是作为一个临时的数据,作用域有限同时一般用来作为数组的下标或循环计数器。
    • 关于命名中的计算值,举例有一下几个:Total, Average, Max, Min, Record; 当我们的程序涉及到类似的表示计算的变量时,最好在命名的时候考虑吧以上类似的限定词加到名称之后(也要注意表明这是什么样的计算值,比如说平均身高:HeightAverage)
    • 注意变量命中常用的对仗词
    一边 另一边
    begin end
    first last
    min max
    locked unlocked
    old new
    visible invisible
    source target
    source destination
    up down

    为特定类型的数据命名

    PS : 我在尽力用直接不含糊的语言去描述,以加强本人的规范编码意识,如若不赞同,勿怪

    • 为循环下标命名:
      在对循环下标命名的时候,不要用i, j, k 之类,用描述性较好的方式去定义这一类变量,《代码大全》中举例:谨慎使用下标串话(index cross-talk)可以避免以下问题:

      1 . 想用 j 的时候写了 i ,想用 i 的时候写了 j
      2 . 同时使用描述性较好的变量名可以是数据访问变得更加清晰:score[teamIndex][eventIndex] 要比 score[i][j]给出的信息要多

    • 为状态量命名:

      1 . 为状态量取一个比flag更好的名字,状态量中最好不要出现flag
      2 . 对于命名状态量而言,枚举类型会是个不错的选择。

    • 为临时变量命名:

      使用temp , x ,等没有明确指向意义的变量名称一般是因为我们没有弄清楚相关问题,因此,我们可能会更加倾向于比其他变量更加随意的对待这些变量,从而增加 了出错的可能性。

    • 为枚举类型命名:

      使用组前缀对枚举类型的变量命名

      Public enum Color{
      Color_Red,
      Color_Blue,
      Color_Green
      }

    相关命名规则示例

    实体 描述
    ClassName 类名混合使用大小写,首字母大写
    TypeName 类型定义,同上
    EnumeratedTypes 除遵从上述规则外,枚举类型总是用复数形式表示
    localVariable 局部变量混合使用大小写,首字母小写
    g_GlobalVariable 全局变量名使用g_前缀
    CONSTANT 常量全部大写
    MACRO 宏全部大写
    Base_EnumeratedType 加枚举前缀

    常用前缀

    UDT:用户自定义类型

    UDT 描述
    ch 字符,character 或者一份文档中的字符
    doc 文档(document)
    pa 段落(Paragraph)
    scr 屏幕区域 (Screen Region)
    sel 选中范围 (selection)
    wn 窗体 (window)
    form 窗体 (winform)

    语意前缀 含义
    lim 上限 (通常为 last + 1)
    m 类一级的变量
    max 数组或列表中绝对的最后一个元素
    min 数组或列表中绝对的第一个元素
    p Pointer 指针

    应该避免的名字

    • 避免使用令人误解的名字或者缩写
    • 避免使用具有相似含义的名字
    • 避免使用具有不同含义但是却极为相似的变量
    • 避免使用发音相近的名字(防止交流的时候出现误解)
    • 避免在命名中使用数字
    • 避免拼写错误的单词
    • 不要仅靠大小写来区分变量
    • 避免使用多种自然语言
    • 避免使用标准类型
    • 不要使用与变量含义完全无关的名字
    • 避免在名字中包含易混淆的字符

    summary key points

    • 好的变量名是提高程序可读性的一项关键因素。对于特殊种类的变量,比如循环下标和状态变量,需要加以特殊考虑
    • 名字要尽可能的具体,那些太模糊的或者太通用的以至于能够用于多种目的的名字通常都是很不好的
    • 命名规则应该能够区分局部数据,类数据和全局数据。它们应该还可以区分类型名,常量,枚举类型名字和变量名。
    • 无论做哪种类型的项目,你都应该采用某种命名规则。你所采用的规则的种类取决于你的程序的规模和项目成员的人数
    • 现代编程语言很少要用到缩写。如果你真的要用缩写,请使用项目缩写词典或者标准前缀来帮你理解缩写
    • 代码阅读的次数远远多于编写的次数。确保你所取的名字更侧重于阅读方便而不是编写方便

    实战总结 c

    • 类中全局变量, 每个单词的首字母都大写
    • 命名空间中的全局变量 用g_标示,标示这是一个所有的类都可以访问的,

      对于全局变量,若要在所有的类中都可以使用,可以选择新建一个静态类,将全局变量都放到里面并设置变量的属性 public static

    • 目录用 dir 作为后缀,而path用做具体文件的命名后缀

    全称 缩写
    current curr
    resource res
    destination dest
    展开全文
  • 变量命名网站

    千次阅读 2019-07-04 11:38:33
  • 变量命名原则

    变量的命名相对而言没有太多的技术含量,今天整理有关于变量命名相关的原则,主要是想告诉大家,虽然命名没有技术含量,但对于个人编码,或者说一个团队的再次开发及阅读是相当有用的。良好的书写规范可以让你的JavaScript代码更上一个台阶,也更有利于团队的再次开发和阅读代码。

    全名原则

    • 变量名区分大小写,允许包含字母、数字、美元符号($)和下划线,但第一个字符不允许是数字,不允许包含空格和其他标点符号
    • 变量命名长度应该尽可能的短,并抓住要点,尽量在变量名中体现出值的类型
    • 尽量避免使用没有意义的命名
    • 禁止使用JavaScript关键词、保留字全名
    • 变量名命名方法常见的有匈牙利命名法、驼峰命名法和帕斯卡命名法

    变量命名方法

    变量命名的方法常见的有匈牙利命名法、驼峰命名法和帕斯卡命名法。这里简单来看看这三种命名法的使用以及它们的不同之处。

    匈牙利命名法

    匈牙利命名法匈牙利命名法是电脑程序设计中的一种变量命名规则,此命名法又可细分为:系统匈牙利命名法和匈牙利应用命名法。

    匈牙利命名法具备语言独立的特性,并且首次在BCPL语言中被大量使用。由于BCPL只有机器字这一种数据类型,因此这种语言本身无法帮助程序员来记住变量的类型。匈牙利命名法通过明确每个变量的数据类型来解决这个问题。

    在匈牙利命名法中,一个变量名由一个或多个小写字母开始,这些字母有助于记忆变量的类型和用途,紧跟着的就是程序员选择的任何名称。这个后半部分的首字母可以大写,以区别前面的类型指示字母。

    匈牙利命名法:

    变量名=数据类型+对象描述
    
    • 数据类型:指点是JavaScript中六种数据类型之一,undefinednullbooleannumberstringObject
    • 对象描述:指对象名字全称或名字的一部分,而且要有明确含义,易记而且还要好理解

    有ES6之后,数据的类型不再是六种了,其新增加了Symbol这个新数据类型,有关于Symbol的相关介绍,可以阅读这篇文章《深入解析ES6: Symbol》。

    先来看个示例

    var aPerson = []; // Array数组
    var oBtn = document.getElementById('btn'); //Object对象
    var fnName = function () {}; // function函数
    var sName = "w3cplus"; // string字符串
    

    如上面的示例中的变量名称aPersonoBtnfnName或者sName。每个变量名前都有代表数据类型的对应字母,然后后面紧跟有意义的单个单词名多个单词,并且单词的字母都大写(其实这种方法,称之为驼峰写法,后面会介绍)。

    JavaScript变量名中代表数据类型都有对应的字线,如下所示:

    • s: 表示字符串String
    • i: 表示整型Int(它是Number中的整数类型)
    • fl: 表示浮点Float(它是Number中的小数类型)
    • b: 表示布尔Boolean
    • a: 表示数组Array
    • o: 表示对象Object
    • fn: 不示函数Function
    • re: 表示正则Regular Expression

    有关于匈牙利命名更多的细节可以点击这里阅读。

    驼峰命名法

    当变量名和函数名称是由二个或多个单字链接在一起,而构成的唯一识别字时,利用“驼峰式大小写”来表示,可以增加变量和函数的可读性。

    “驼峰式大小写(Camel-Case)一词来自Perl语言中普遍使用的大小写混合格式,而Larry Wall等人所著的畅销书《Programming Perl》(O'Reilly出版)的封面图片正是一匹骆驼。”

    “驼峰式大小写”命名规则可视为一种惯例,并无绝对与强制,为的是增加识别和可读性。一旦选用或设置好命名规则,在程序编写时应保持一致格式。

    驼峰命名法常见有两种格式:

    • 小驼峰式命名法(lower camel case):第一个单字以小写字母开始;第二个单字的首字母大写,例如:firstNamelastName
    • 大驼峰式命名法(upper camel case):每一个单字的首字母都采用大写字母,例如:FirstNameLastNameCamelCase,也被称为Pascal命名法

    有关于驼峰式命名方法更多的介绍,可以点击这里阅读。

    帕斯卡命名法

    Pascal命名法(Pascal Case,巴斯卡命名法/帕斯卡命名法),电脑程序编写时的一套命名规则(惯例)。

    当变量名和函数名称是由二个或二个以上单字链接在一起,而构成的唯一识别字时,用以增加变量和函数的可读性。

    单字之间不以空格断开或连接号(-)、下划线(_)链接,第一个单前缀字母采用大写字母;后续单字的首字母亦用大写字母,例如:FirstNameLastName。每一个单字的首字母都采用大写字母的命名格式,被称为“Pascal命名法”,源自于Pascal语言的命名惯例,也有人称之为“大驼峰式命名法”(Upper Camel Case),为驼峰式大小写的子集。

    “Pascal命名法”可视为一种命名惯例,并无绝对与强制,为的是增加识别和可读性。一旦选用或设置好命名规则,在程序编写时应保持格式的一致性。

    有关于帕斯卡命名法更详细的介绍可以点击这里阅读。

    虽然上面三种方法在JavaScript中命名变量常见的方法,也是很多规范推荐使用的命名方法;但除此之外还有别的方法。比如说变量名有两个或多个单词时,可以在多个单词间使用-_连接起来。如first-name或者说first_name

    总结

    文章简单介绍了一些有关于在JavaScript中变量命名的一些原则。并且介绍了变量命名的常用的几种方法,比如匈牙利命名法驼峰命名法帕斯卡命名法等。不管使用什么方法来命名一个变量,但文章开始提到变量名区分大小写,允许包含字母、数字、美元符号($)和下划线,但第一个字符不允许是数字,不允许包含空格和其他标点符号变量名禁止使用JavaScript关键词、保留字全名这两点,不然很容易给代码带来灾难性的错误。

     

    如需转载,烦请注明出处:http://www.w3cplus.com/javascript/variable-naming-principles.html

    展开全文
  • Python变量命名规则

    万次阅读 多人点赞 2018-03-15 14:07:08
    Python变量命名规则 变量名只能包含字母、数字和下划线。变量名可以字母或下划线开头,但不能以数字开头,例如,可将变量命名为message_1,但不能将其命名为1_message。 变量名不能包含空格,但可使用下划线来分隔...

    Python变量命名规则

    • 变量名只能包含字母、数字和下划线。变量名可以字母或下划线开头,但不能以数字开头,例如,可将变量命名为message_1,但不能将其命名为1_message。
    • 变量名不能包含空格,但可使用下划线来分隔其中的单词。例如,变量名greeting_message可行,但变量名greeting message会引发错误。
    • 不要将Python关键字和函数名用作变量名,即不要使用Python保留用于特殊用途的单词,如print。
    • 变量名应既简短又具有描述性。例如,name比n好,student_name比s_n好,name_length比length_of_persons_name好。
    • 慎用小写字母l和大写字母O,因给他们可能被人错看成数字1和0;

    注意:应使用小写的Python变量名。在变量名中使用大写字母虽然不会导致错误,但避免使用大写字母是个不错的注意。

    展开全文
  • c++变量命名规范

    2020-09-26 17:36:21
    变量命名规则是为了增强代码的可读性和容易维护性。以下为C++必须遵守的变量命名规则: 变量名只能是字母(A-Z,a-z)和数字(0-9)或者下划线(_)组成。 第一个字母必须是字母或者下划线开头。 不能使用C++关键字...
  • java-变量命名

    千次阅读 2018-04-01 20:41:44
    java-变量命名 1.变量命名规则 2.变量命名规范 3.举例 java-变量命名 1.变量命名规则 首字母为:字母、下划线、$; 其余字母为:字母、下划线、$、数字; 2.变量命名规范 小驼峰 不能是...
  • 变量命名规则

    2019-03-27 17:02:25
    文件及文件夹命名:所有字母均小写。 类的命名:所有单词的首...变量命名: 驼峰式:第一个单词字母小写,之后的单词首字母均大写。 常量命名:所有字母均大写。 代码是写给程序员看的,而不是写给计算机看的。 ...
  • Java 变量命名规则

    万次阅读 2018-12-16 14:46:14
    变量命名必须满足一系列的条件,不能随意命名 示例 1 : 命名规则 变量命名只能使用:字母 数字 $ _  变量第一个字符只能使用:字母 $ _  变量第一个字符不能使用:数字  注:_ 是下划线,不是-减号或者—— 破...
  • 变量命名规范

    万次阅读 2015-10-25 21:52:40
    变量命名规范本节内容主要参考自代码大全(第二版)1、变量命名的注意事项 变量命名最关键的一点就是:名字要能准确的描述出该变量所代表的事物 变量名长度最好控制在10~16个字符之间 对位于全局命名空间中的名字加以...
  • js变量命名规则

    千次阅读 2019-10-05 14:56:19
    变量命名规则如下: 1、变量命名必须以字母、下划线”_”或者”$”为开头。其他字符可以是字母、_、美元符号或数字。 2、变量名中不允许使用空格和其他标点符号,首个字不能为数字。 3、变量名长度不能超过255个字符...
  • 1存储值的命名内存区域,以使程序存储和或者操作值 2变量的类型决定存储的数据类型 3如果存储一个单独的值,使用标量变量 4如果存储多个值(一行记录),使用复合类型的变量标量变量 1包含一个单独值的变量 2...
  • javascript变量命名规则

    千次阅读 2019-05-22 21:00:49
    javascript变量命名规则: 以字母、下划线、$开头; 区分大小写; 由字母、下划线、$或数字组成; 不能使用关键字和保留字
  • [C#]变量命名

    2019-05-31 23:11:39
    状态变量命名不要出现flag,最好用枚举变量、具名常量或用作具名常量的全局变量来赋值。 临时变量命名 用真正的变量来代替临时变量。(其实不存在临时变量的说法,所有的变量都算是临时的) 布尔变量命名 列出几...
  • vba变量命名惯例

    千次阅读 2017-11-16 23:37:51
    vba变量命名惯例
  • js变量命名规范

    千次阅读 2019-09-05 20:13:08
    js中主要有数据,第一:数据的存储,第二:数据...变量命名规范 1.可以使用驼峰式命名 zhuMingXing 可以使用只读下划线特殊字符命名 2.不能使用中文,其它语言 3.不能使用js中关键字进行命名:window document 包括a...
  • Java变量命名规则

    万次阅读 2016-10-10 17:57:17
    Java变量命名规则
  • 变量的命名相对而言没有太多的技术含量,今天整理有关于变量命名相关的原则,主要是想告诉大家,虽然命名没有技术含量,但对于个人编码,或者说一个团队的再次开发及阅读是相当有用的。良好的书写规范可以让你的...
  • JS变量命名规范

    千次阅读 2017-01-10 16:48:06
    JS变量命名规范
  • c++变量命名规则

    千次阅读 2019-01-27 19:30:05
    浅谈C++变量命名规则    匈牙利命名法的来历和介绍分类:C Plus Plus 匈牙利命名法是一种编程时的命名规范。基本原则是:变量名=属性+类型+对象描述,其中每一对象的名称都要求有明确含义,可以取对象名字全称...

空空如也

空空如也

1 2 3 4 5 ... 20
收藏数 50,265
精华内容 20,106
关键字:

变量命名