背景
在 JavaScript 的代码规范方面，不同开发者、公司、团队有着自己的习惯和要求。但是因为代码规范的分歧，导致了代码的可读性和可维护性问题。为了解决这个问题，引入了代码校验工具。
jscodesniffer 是一款基于 JSHint 和 Esprima 的 JavaScript 代码校验工具。它能够让你在编写 JavaScript 代码的时候就使用自己公司或者你团队的代码规范标准，以保证代码的一致性和稳定性。
在本篇文章中，我们将会深入了解 npm 包 jscodesniffer 的使用方法和使用场景。
安装
全局安装 jscodesniffer：
npm install jscodesniffer -g
使用
在项目根目录下新建 .jscsrc 文件，文件包含了校验规则的 JSON 形式定义。
.jscsrc 文件栗子：
-- -------------------- ---- -------
-
--------------- -----------------------
------------ ----
-------------- ---
--------------------- -
------------ ---------------
--
--------------------- -----
------------------------------- ----
-针对根目录下所有 JS 文件运行 jscodesniffer：
jscodesniffer .
或者，运行某个特定的文件：
jscodesniffer example.js
规则说明
在 .jscsrc 文件中，根据团队或者公司的代码规范，可以定义不同的校验规则。
下面我们列出一些比较常用的规则和说明，方便大家作为参考：
requireCurlyBraces
要求所有控制语句使用大括号。此类规则的示例：
{
"requireCurlyBraces": true
}semi
要求语句末尾使用分号。此类规则的示例：
{
"semi": true,
"newcap": true,
"camelcase": true
}requireDotNotation
要求对象属性使用点符号运算符而不是方括号。
{
"requireDotNotation": true,
"newcap": true,
"camelcase": true
}requireParenthesesAroundIIFE
要求立即调用的函数表达式 (IIFE)使用括号包裹。
{
"requireParenthesesAroundIIFE": true,
"newcap": true,
"camelcase": true
}指导意义
使用 jscodesniffer 可以规范和风格化公司的 JavaScript 代码，让代码易读易维护。同时，公司可以通过查看校验结果统计出代码中的问题和错误，进行代码质量的监控和管理。
而对于开发者来说，jscodesniffer 作为一个工具，在开发过程中能够辅助他们改善他们的编码，让代码更容易查找和诊断潜在问题。
示例
下面，我们将简单介绍一下如何编写一个符合 JSCS 规范的 JavaScript 文件。
-- -------------------- ---- -------
--------- -- -
---- --------
-- ------ --- --------- ---- ---- -- ---- ---------- --- -----
--- -------- - ----- -- - -----------
----------- - ----- -- - ----------
----------------- - ----- -- - ------ -- ------ ---------
----------------- - ----- -- - ------ -- ------ ---------
-- ------ - -----
-------- --------- -
---------------- - ------
-
--------------------------- - -------- -- -
-- ------------------ -
---------------- -------- --- -- --------
-
--
-- ---- ------- -------- --------
--- ---- - - -- ------ - --- - - ------- ---- -
---------------
-
-- ------ -- ----- --------
--------------------------------- -------- -- -
---------------- ------ --- -----------
---
-----可以看出，这个 JavaScript 文件非常符合 jscodesniffer 的校验规则。对于开发者来讲，这里采用的是不使用花括号的函数体语法规则，即使只有一行代码，也是应该使用花括号将这一块代码包裹起来，以规范代码格式。
同时，每个变量都使用 var进行声明，这一点也是符合 jscodesniffer 的校验规则的。
##总结
jscodesniffer 是一个非常有用和实用的 JavaScript 代码校验工具。可以方便我们在编写 JavaScript 代码的时候就采用团队或者公司指定的编码规范，同时还能够让开发人员自由地定义和调试输入规范的方式。最终，jscodesniffer 为团队协作和协调以及代码的质量保证带来了很大的益处。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/78006