用standard来管理JavaScript 代码规范

时间: 2017-12-22阅读: 940标签: standard

怎么才能使前端团队写的JavaScript代码都有统一的风格、符合规范呢?要解决这个问题大概要做下面几件事:

制定规范标准
写代码时执行代码规范
检查代码是否符合规范
修改不符合规范的代码

那么,到底具体应该如何实施以上几个步骤呢?我的回答是你什么都不用做了,有人已经帮你把以上四步全部做好了!是的,这个好用的工具就是本文要介绍的JavaScript规范库,standarad


关于standard

standard是什么?

一个开源的JS代码规范库,它做了以下事情

制定了所谓standard(标准)的JS代码规范
配合编辑器插件可以实时检查代码规范以及语法错误
通过执行命令检查代码规范以及语法错误
自动修复(可以直接修复的)不合规范的代码,使其符合规范


关于standard中的代码规范

可以说JS这门语言的魅力之一就是自由、开放的写法,相比python、Go等语言,JS写起来自由的多。但是这种自由本身在团队合作的项目里也带来了很多的不便,于是我们需要指定代码规范,但是应该以什么标准来制定规范呢?缩进到底是4格还是2格、结尾要不要用分号、花括号和if语句在同一行还是另起一行?诸如此类的问题,从功能和逻辑上来讲并没有标准答案,因为无论怎么选,代码都能运行,功能都能实现。所以在JS程序员的世界里经常会有诸如缩进、分号、换行等写法的争论,standard库对此给出的结论是,这种争论对于getting stuff done并无意义,我们要停止这方面的争论,把精力放在解决问题上。

standard官方给出的说法如下:

There are lots of debates online about tabs vs. spaces, etc. that will never be resolved. These debates just distract from getting stuff done. At the end of the day you have to ‘just pick something’, and that’s the whole philosophy of standard – its a bunch of sensible ‘just pick something’ opinions. Hopefully, users see the value in that over defending their own opinions.


使用standard

好了,开始使用standard吧。

新建一个项目

mkdir my-project
cd my-project


安装standard

npm init
npm install standard --save-dev


安装snazzy,让代码检查的结果输出更加美观

npm install snazzy --save-dev


配置package.json, 添加一条名为lint的npm script

"scripts": {
 "lint": "standard --verbose | snazzy"
}


在项目下新建一个app.js文件,随意输入一些代码并保存

// app.js             // 错误说明
const a = 1;          // 结尾不应该有分号,而且a定义了没有使用
const f = () => {}    // f定义了但是没有使用
log()                 // log未定义


运行代码检查

npm run lint


看到检查结果

1:7   error  'a' is assigned a value but never used  no-unused-vars
1:12  error  Extra semicolon                         semi
2:7   error  'f' is assigned a value but never used  no-unused-vars
4:1   error  'log' is not defined                    no-undef


standard的更多功能

  1. 使用编辑器插件,实时检查代码规范
  2. 忽略某些不需要执行代码规范的文件
  3. 局部禁用代码检查
  4. 指定全局变量,以避免变量未定义错误
  5. git pre-commit钩子,在每次commit之前检查代码规范
  6. 为更多最新的JS语法添加检查规范
  7. 自动修复


总结

standard应该是当前最好用的JS代码规范库,它无须更多配置,基本做到了安装即用,而且还有很多扩展功能,应该能够满足大多数项目的代码检查需求。本文转载博客

吐血推荐

1.阿里云: 本站目前使用的是阿里云主机,安全/可靠/稳定。点击领取2000元代金券、了解最新阿里云产品的各种优惠活动点击进入...

2.腾讯云: 提供云服务器、云数据库、云存储、视频与CDN、域名等服务。腾讯云各类产品的最新活动,优惠券领取点击进入...

3.站长广告联盟: 整理了目前主流的广告联盟平台,如果你有流量,可以作为参考选择适合你的平台点击进入...

链接: http://www.fly63.com/article/detial/271

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

广告赞助文章投稿关于web前端网站点搜索站长推荐网站地图站长QQ:522607023

小程序专栏: 土味情话心理测试脑筋急转弯幽默笑话段子句子语录成语大全