如何给程序中的变量起个好名字?

更新日期: 2019-09-24阅读: 2.2k标签: 变量

对一个人来说,名字很重要,俗语说“人如其名”。对程序中的变量而言,名字同样非常重要。

作为开发人员,你要花费大量的敲代码时间来创建变量和考虑给变量起个名字。 名字无处不在。 你可以命名文件、类、方法和变量。而命名的不同导致有的是好代码,有的是糟糕的代码,最终这会严重影响代码维护的成本。

由于我们花费大量时间命名变量,因此做好它非常重要。 在本文中,我将向你展示一些简单的规则,你可以遵循这些规则来创建名字。

在代码中起名本身就是一门艺术!


1、名字要显示真正意图

这说起来容易做起来难。 你多久遇到一次变量名,而这些变量名没有告诉你有关变量的真实信息?

一个好的经验法则是:如果一个名字需要注释,那么它并不是真实意图的命名。

编程大师 Robert C. Martin 在《Clean Code》中说道: “使用注释是为了弥补我们代码表意上的不足。”

这句话意味着如果你的代码需要添加注释,就说明你的代码还不够好。同时,这也说明如果不能在单纯的代码中展示你对问题或算法的理解,这是非常失败的,你只能依靠一些注释说明你的想法,而不能仅用代码。

优秀的代码可以让人在没有注释的情况下看懂并理解,好的编程习惯也是让所有必要的信息都在代码中展示出来。

以下代码段是一个变量,它不能揭示真正的意图:

<?php
	private $s; // Time in seconds

变量 $s 没有显示任何意义。

它不会看到任何时间流逝的含义。最好选择一个名称,该名称指定要测量的内容以及该测量的单位。因此,很重要的一点就是,程序员要用代码准确的表达出自己的思想,从而让其他人明白程序的含义。

下面的示例中的变量名会更好,任选其一。

<?php
	private $days_since_creation;
	private $elapsed_time_in_seconds;
	private $seconds_since_last_modified;

选择显示意图的名称可以使理解一段代码变得更加容易,因此也易于维护。选择名字需要时间,但是比起维护代码,整体节省时间要多得多。

让我们看一下以下示例:

<?php
	
	function getList() {
	    $list1 = [];
	    
	    foreach ($this->the_list as $x) {
	        if ($x % 2 != 0) {
	            $list1[] = $x;
	        }
	    }
	    
	    return $list1;
	}
	
	function getOddNumbers() {
	    $odd_numbers = [];
	    
	    foreach ($this->numbers as $number) {
	        if (isOdd($number)) {
	            $odd_numbers[] = $number;
	        }
	    }
	    
	    return $odd_numbers;
	}

为什么 getList 函数的作用这么难辨别?它并没有复杂的表达式。代码已缩进并正确格式化。只使用了三个变量,没有花里胡哨的东西。

再看一下 getOddNumbers 函数。你是否看到该函数与 getList 函数完全相同?

注意,代码的复杂度没有改变。它仍然具有完全相同数量的运算符和变量,以及完全相同数量的嵌套逻辑。唯一改变的是代码命名变得更加明确。

通过简单的名称重构,我们很容易分辨出这段代码的功能。


2、使用某一领域背景中有意义的名字

程序员写的所有代码都是和某一领域背景相关的,为了让写出的代码可以让个更多的人理解,最好使用该领域背景下的名字。

不好的代码示范:

public class  EntitiesRelation
{
Entity o1;
Entity o2;
}

当你在编写针对某个领域的代码时,你应该使用领域背景相关的名字。如果以后有另外的人(不仅是程序员,也许是测试人员)接触你的代码时,他能轻松的理解你写背景相关的代码含义。

所以,程序员首先应该考虑的是领域背景问题,之后才是如何出解决方案。

清晰的代码示例:

public class  ProductWithCategory
{
Entity product;
Entity category;
}


3、避免误导信息

你应该避免留下掩盖代码含义的错误提示。

避免误导其含义与预期含义有所差异的词。例如,不要将产品分组称为 productList,除非它实际上是 List 类型的对象。这可能导致错误的结论。一个更好的名字将是产品。

Product[] products;

你可能选择的最差的变量名称是大写的 O 和小写的 L。这是因为它们看起来很像 0 和 1。

当心使用名称变化很小的名称。发现一个文件中的 SomeMethodForEfficientHandlingOfFiles 和另一个文件中的 SomeMethodForEfficientStorageOfFiles 之间的细微差别需要多长时间?乍一看,这些名称看起来相同。

导致误解的信息比没有信息更糟糕,有些程序员喜欢“隐藏”一些重要信息,但更糟的是,他们有时会写出一些让人误解的代码。

命名混淆:一个词不要表示多种概念

定义场景中的概念很难,在软件开发过程中,程序员需要花费很多时间去分析某一场景,并命名场景中的各种元素,这样的工作永远都是让程序员头疼的事情。

不好的代码示例:

//1.
void  LoadSingleData();
void  FetchDataFiltered();
void  GeteAllData();
//2.
void  SetDataToView();
void  SetObjectValue(int value);

在第一段代码中,这个程序员想表达“获取数据”这个概念,但他用了很多不同的词”load”,”fetch”, ”get”。在一个场景下,应该用一个统一的词表示这个概念。

在第二段代码中,”set”一词被用作了两个概念,第一个是“取出数据显示”,第二个是“为一个对象赋值”,应该用不同的词表示这两个不同的概念。

清晰的代码示例:

//1.
void  GetSingleData();
void  GetDataFiltered();
void  GetAllData();

//2.
void  LoadDataToView();
void  SetObjectValue(int value);


4、做出有意义的区分

数字系列命名不是一个命名的好方法。这样的名称是非信息性的,因为它们没有提供代码作者意图的任何提示。

让我们看下面的例子:

<?php
	
	public function duplicateArray($arr1, &$arr2) {
	  foreach ($arr1 as $key => $value) {
	    $arr2[$key] = $value;
	  }
	}

当将 arr1 arr2 重命名为 source destination 时,此代码将更好地阅读。


5、使用可以发音的单词

如果不能说出名字,那么你就不能在听起来像个白痴的情况下讨论它。这实际上很重要,因为编程的一部分工作是社交活动,每个人都有很大的机会知道自己无法发音的变量名称。

假设我们有一个名为 $xsq 的变量名,这对贵公司来说是一个非常重要的缩写。想象一下与同事的对话:

“嘿,那可变的 eks ess kjew 呢?”

“你是说访问队列?”

一些开发人员将尝试将变量发音为一个单词。其他人会拼出这个词。

变量命名: 使用在上下文有意义的名字

代码里的名字都有自己的上下文,上下文对于理解一个代码是很重要的,因为它能提供额外的信息。我们来看一个典型的“地址”上下文:

不好的代码示例:

string addressCity;
string addressHomeNumber;
string addressPostCode;

在大多数情况中,“邮政编码”(PostCode)是地址的一部分,很显然,邮政编码不能单独使用(除非你是在开发一个专门处理邮编的应用)。

所以,没有必要在“PostCode”的前面加上“address”。而且,所有的这些信息都应该有一个上下文环境,在面向对象编程中,这里应该用一个“Address”类来表达这个地址信息。

清晰的代码示例:

class Address{
   string city;
   string homeNumber;
   string postcode;
}


6、使用可搜索的名称

由一个字母组成的名称,可能存在难以定位的问题。

数字常量也是如此。数值常量可以用常量变量代替。搜索代码时,数字 8 可能会给你带来很多麻烦。

但是,用常量 MAX_BLOCKS_DISPLAYED 替换它会使它变得更容易。

单字母名称的唯一用例是简短方法中的局部变量。


7、命名前缀

不要使用前缀。

例如,某些开发人员习惯在所有私有成员前面加上下划线。别,你的类和方法应该足够短小,以至于不需要任何这些前缀。

或者,你可以使用 IDE(或安装插件),该 IDE 根据变量的范围会为变量着色。


结论

这样,你可以在代码中创建更有意义的名称。

作为一名程序员你应该:

1、起的名字有意义,可以表达一个概念

2、要考虑名字的长度,名称中只有必要信息

3、符合“编码规范”,有助于理解

4、一个概念不要多个名字混用

5、使用在背景领域和上下文中都有意义的名字

本文的灵感来自罗伯特·C·马丁(Robert C. Martin)所著的《清洁代码》(Clean Code),我强烈建议你仔细阅读。

英文原文:How To Create Meaningful Names In Code


链接: https://www.fly63.com/article/detial/5522

css自定义变量_初次接触CSS变量

本文的目的主要是展示CSS变量是如何工作的。随着Web应用程序变得越来越大,CSS变得越来越大,越来越多,而且很多时候都很乱,在良好的上下文中使用CSS变量,为您提供重用和轻松更改重复出现的CSS属性的机制。

CSS变量(自定义属性)实践指南

Sass和Less这样的预处理器,让我们的CSS代码保持良好的结构和可维护性。像变量、混合(mixins)、循环控制等特性,增强了动态编写CSS的能力,从而减少重复代码,也加快了我们开发速度。

css变量_原生css 中变量的使用

原生css 中变量的使用,这个重要的 CSS 新功能,所有主要浏览器已经都支持了。本文全面介绍如何使用它,你会发现原生 CSS 从此变得异常强大。声明变量的时候,变量名前面要加两根连词线(--),var()函数用于读取变量。

理解var let const区别

JavaScript中var、let、const区别?js中let和const都是es5版本新的命名规范,在此之前定定义一个变量只能用var。我们可以把let和const看做是为了弥补var的一些不足而新设计出来的

一个例子,变量提升和函数提升就是这么简单!

引擎在读取js代码的过程中,分为两步。第一个步骤是整个js代码的解析读取,第二个步骤是执行。在JS代码执行之前,浏览器的解析器在遇到 var 变量名 和function 整个函数 提升到当前作用域的最前面。

CSS变量使用解析

很早直接就了解到CSS变量相关的内容,奈何之前使用价值不高(很多主流浏览器不兼容),最近发现主流浏览器都已经支持了这一变化,CSS变量就像JS的变量,每个类名或者花括号就像一个function,里面的变量只有上下文以内可以获取,这就让CSS有了更多可能性。

let与var的区别,为什么要用let?

var是全局声明,let是块级作用的,只适用于当前代码块;var变量会发生变量提升,let则不会进行变量提升;var 会造成重复赋值,循环里的赋值可能会造成变量泄露至全局

ES6-变量的解构赋值

解构赋值官方解释:按照一定的模式,从数组和对象中提取值,对变量进行赋值,这被称为解构(Destructuring)。变量的解构赋值就是一种写法,掌握了这种写法可以让我们在书写 javascript 代码时可以更加的简单,迅捷。

JS中变量的存储

JS中的变量是保存在栈内存中的:1.基本数据类型的值直接在栈内存中存储;2.值与值之间是独立存在的,修改一个变量不会影响其他变量;对象是保存到堆内存中的,每创建一个新的对象

js 交换变量值的方法总汇

这篇文章总结七种办法来交换a和b的变量值 。最最最简单的办法就是使用一个临时变量了 ,最后我的方案是利用了ES6的解构赋值语法 ,它允许我们提取数组和对象的值,对变量进行赋值

点击更多...

内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!