清云小程序教程七： 小程序代码编写规范

原文链接：http://www.0575yun.com/articledetail/id/64.html

今天来说说微信小程序的一些代码编写规范，对于规范呢，大家要有一定的清晰和明确的认识。这里的规范不是一成不变的，很多时候的规范其实只是一种约束，它其实并没有对错。什么意思呢？比如说这个“image”组件，它可以成对出现，也可以不成对出现，并没有一个特别的规定。那么到底要成对出现还是不成对出现呢，这个是一个约定俗成的惯例。

有的团队呢，他觉得要成对出现，那么，成对出现就是一个规范；而如果你的团队觉得他不需要成对出现，那这个就是你自己的一个规范了。再举一个例子，比如说这个属性值，到底用单引号（’‘），还是用双引号（“ ”），那么它同样的应该有一种规范的约束。比方说在我的团队里或者我自己编写代码的时候，我要求这些属性都是必须要写双引号，那它就是一种规范。记住每一项行为都有它自己的规范。

在我们写js里面，命名一个变量，一般我们要求是驼峰写法，也就是“onBind”这样的命名方式来定义一个变量；而其他比方说，也有“on_bind”这样的方式，它们2个单词之间是用下划线来连接的。所以说，不同的语言，不同的技术，它也有它约定俗成的规范。

我们简单说一下，制定一个团队的一系列规范的时候的一些原则。首先，你的这些规范不能引起代码的错误，这是一个最基本的原则。这点大家应该都知道。另外的一个原则就是，你在制定规范的时候，你首先是要遵守一个语言或者一个技术的大规范。比如说，在js中，js最基本的规范就是它的驼峰定义变量的写法，那你的团队在制定规范的时候就不能够违反这个规范，像“on_bind”这样以下划线连接的定义方式是违反了js的大规范的。在自己制定规范的时候，你自己要知道先要满足这个语言的大规范，然后再在这个大规范的前提下去制定自己团队的小规范。千万不要小瞧这个规范，规范真的是很重要的，如果一个团队没有规范，或者你自己没有规范，你各种代码的命名，文件的命名，变量的命名，没有规范，乱七八糟的，你自己看着也难受，所以千万不要小瞧规范。

而且规范的细节特别多，刚才只是随便举了一些例子，还可以举出更多的例子。比如说，我们在写代码的时候，经常要涉及到文件和文件夹的命名。

比如说“image-button”,你是以2个单词不加任何的驼峰的形式呢，还是2个单词之间有“-”短横线连接，还是以“_”下划线连接，在js里面这些都可以，但是到底选择哪一种的，这个就很纠结。写代码就是这样，纠结，就很难受。

再比如说，我们写js文件的时候，它也有很多规范。

比如说，每一行js代码，后面到底要不要写”；"，这个也是一个很纠结的问题，大家可以看到，这里都是没有加分号的。这里要说一点，如果你要加分号“；”，那你就全部都加分号；如果不加，就全部都不要加，这个由你自己决定。这里说说，为什么不加分号，因为我写了太多的js代码，这里它是不需要加分号的。有些同学会说，那么这个js代码后面到底需不需要加分号，我也在网上查了，其实这个东西他也没有一个明确的说法，有人说要加分号，有人说不加分号，众说纷纭的，根本没有一个统一的标准，所以说，这个就看大家自己的了。不过这又要提醒大家一点了，如果没有加分号，在压缩这个代码的时候，有可能在压缩后会出现代码错误的问题。但是我已经习惯了在写js代码的时候不加分号了，这么久了也没有遇见过这个压缩后出现代码错误的问题。这个也是我的一个习惯，能少打一个分号就少打一个分号，能少写一个是一个，这个就看大家自己的习惯了。

那么，最后我们来说一下，刚刚我们随便举得一些例子，大家就看到了有各种各样的规范是需要注意的，那么如果大家有自己的一些习惯，就按照自己的习惯好了，只要不违背我们语言的大规范就行。在官方的文档中，也给出了一些规范，大家可以去看看。