教程七: 小程序代码编写规范

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

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

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

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

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

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

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

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

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


版权保护: 本文由 清云小程序 原创,转载请保留链接: http://www.0575yun.com/articledetail/id/64.html