前言
关于程序员开发规范,小编之前也整理了不少的优质文章:
前端开发规范:命名规范、html规范、css规范、js规范
【规范篇】前端团队代码规范最佳实践
你需要的 React + TypeScript 50 条规范和经验
大厂Code Review总结Vue开发规范经验「值得学习」
今天有整理一篇编码标准可以帮助以下方面:
- 保持代码一致
- 易于阅读和理解
- 易于维护
下面的编码标准是我对上述几点有帮助的看法。
1. 比较时使用 === 代替 ==
这很重要,因为JavaScript是一种动态语言,因此使用==可能会给您带来意想不到的结果,因为它允许类型不同。
Fail:
if (val == 2)
Pass:
if (val === 2)
2. 永远不要使用 var,使用 let 来代替
使用 let 将有助于避免 JavaScript 中各种 var 引起的作用域问题。
Fail:
var myVar = 10;
Pass:
let myVar = 10;
3. 使用 const 代替 let
这阻止了开发人员尝试更改不应该做的事情,并且确实有助于提高可读性。
Fail:
let VAT_PERCENT = 20;
Pass:
const VAT_PERCENT = 20;
4. 始终使用分号(;)
尽管这在 JavaScript 中是可选的,并不像其它语言一样需要分号作为语句终止符。但是使用 ; 有助于使代码保持一致。
Fail:
const VAT_PERCENT = 20;let amount = 10return addVat(amount, vatPercent)
Pass:
const vatPercent = 20;let amount = 10;return addVat(amount, vatPercent);
5. JavaScript中的命名约定
- let 应该使用驼峰命名。
- const 如果在文件的顶部使用大写的蛇形命名法。如果不在文件顶部,请使用驼峰命名。
- class 应该是帕斯卡命名法:MyClass
- functions 函数应该是驼峰命名法:myFunction
6. 拼接字符串时使用模板字符串
模板字符串中允许嵌入表达式。
Fail:
let fullName = firstName + " " + lastName;
Pass:
let fullName = `${firstName} ${lastName}`;
7. 尽可能使用ES6箭头函数
箭头函数是编写函数表达式的更简洁的语法。
Fail:
var multiply = function(a, b) { return a* b;};
Pass:
const multiply = (a, b) => { return a * b};
8. 始终在控制结构周围使用大括号
所有控制结构都必须使用花括号(例如,if,else,for,do,while等),这样后期维护时,不容易出错。
Fail:
if (valid) doSomething();if (amount > 100) doSomething();else if(amount > 200) doSomethingElse();
Pass:
if (valid) { doSomething();}if (amount > 100) { doSomething();} else if(amount > 200) { doSomethingElse();}
9. 确保大括号从同一行开始,中间有空格
Fail:
if (myNumber === 0){ doSomething();}
Pass:
if (myNumber === 0) { doSomething();}
10. 尝试减少嵌套
if 中嵌套if 会变得混乱并且很难阅读。有时你可能无法解决问题,但是可以好好查看代码,看看是否可以改进。
Fail:
if (myNumber > 0) { if (myNumber > 100) { if (!hasDiscountAlready) { return addDiscountPercent(0); } else { return addDiscountPercent(10); } } else if (myNumber > 50) { if (hasDiscountAlready) { return addDiscountPercent(5); } } else { if (!hasDiscountAlready) { return addDiscountPercent(0); } else { return addDiscountPercent(1); } }} else { error();}
Pass:
if (myNumber <= 0) { return error;}if (!hasDiscountAlready) { return addDiscountPercent(0);}if (myNumber > 100) { return addDiscountPercent(10);}if (myNumber > 50) { return addDiscountPercent(5);}return addDiscountPercent(1);
通过上面的示例可以看出,减少嵌套之后,会变得容易阅读。
11. 尽可能使用默认参数
在 JavaScript 中,如果你在调用函数时没有传递参数,则它的值就是 undefined
Fail:
myFunction(a, b) { return a + b;}
Pass:
myFunction(a = 0, b = 0) { return a + b;}
12. `Switch` 语句应使用 `break` 并具有 `default`
我通常会尝试不使用 switch 语句,但是你确实想使用它,请确保每个条件都break ,并写了 defalut。
Fail:
switch (myNumber){ case 10: addDiscountPercent(0); case 20: addDiscountPercent(2); case 30: addDiscountPercent(3);}
Pass:
switch (myNumber){ case 10: addDiscountPercent(0); break; case 20: addDiscountPercent(2); break; case 30: addDiscountPercent(3); break; default: addDiscountPercent(0); break;}
13. 不要使用通配符导入
Fail:
import * as Foo from './Foo';
Pass:
import Foo from './Foo';
14. 使用布尔值的快捷方式
Fail:
if (isValid === true)if (isValid === false)
Pass:
if (isValid)if (!isValid)
15. 尝试避免不必要的三元语句
Fail:
const boo = a ? a : b;
Pass:
const boo = a || b;
总结
任何语言的编码标准都可以真正帮助提高应用程序的可读性和可维护性。如果你在团队中工作,那么一件很难的事情就是强制执行编码标准。这里有一些建议可以帮助你:
- 代码审查,逐行Pass代码。
- 整理或使用某种代码分析器
- 创建新内容时,让你们的一位高级开发人员初始化,其他开发人员可以使用该代码作为指导。