15 个书写 JavaScript 代码的整洁之道(实用!)
Posted SHERlocked93
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了15 个书写 JavaScript 代码的整洁之道(实用!)相关的知识,希望对你有一定的参考价值。
原文链接: https://medium.com/javascript-in-plain-english/15-rules-for-writing-clean-javascript-8e2b2b426515
无论你是 React 开发者还是 Node.js 开发者. 都能写出可以运行的代码. 但是你写的代码美观并且别人能看懂吗?
下面的规则可以让你的 JavaScript 代码更加整洁和清晰.
规则1. 不要使用随机的字符作为变量
不要使用随机字符去表示一个变量.
// BAD
const x = 4;
应该采用语义化的方式去命名变量.
// GOOD
const numberOfChildren = 4;
规则2. 使用驼峰式命名
不要使用蛇形命名(snake_case
)、帕斯卡命名(PascalCase
)或者变量名以动词开头.
// Bad: 以大写字母开头
var UserName = "Faisal";
// Bad: 以动词开头
var getUserName = "Faisal";
// Bad: 使用下划线
var user_name = "faisal";
使用驼峰命名法代替, 并且使用名词.
// Good
const userName = "Faisal";
规则3. 使用良好的驼峰来命名函数
函数名不要用名词, 避免与变量名混淆.
// Bad: 以大写字母开头
function DoSomething() {
// code
}
// Bad: 以名词开头
function car() {
// code
}
// Bad: 使用下划线
function do_something() {
// code
}
而应该使用驼峰式命名, 并且以动词开头.
//GOOD
function doSomething() {
// code
}
规则4. 使用帕斯卡来命名构造函数
// Bad: 以小写字母开头
function myObject() {
// code
}
// Bad: 使用下划线
function My_Object() {
// code
}
// Bad: 以动词开头
function getMyObject() {
// code
}
同样的, 构造函数名不应该以动词开头, 并且通过 new
来创建对象实例是一个动作.
// GOOD
function MyObject() {
// code
}
规则5. 全局常量
全局常量的值不能被改变, 不应该以命名正常变量的方式来命名它.
// BAD
const numberOfChildren = 4;
// BAD
const number_of_children = 4;
所有的单词应该大写, 并且以下划线分隔.
// GOOD
const NUMBER_OF_CHILDREN = 4;
规则6. 分配变量
不要直接将一个 比较值
分配给变量.
// BAD
const flag = i < count;
应该使用小括号包裹:
// GOOD
const flag = (i < count);
规则7. 相等运算符的用法
不要使用 "==" 或 "!=" 来对比值. 因为它们不会检查两个值的类型是否相同.
//BAD
if (a == b){
//code
}
而应该使用 "===" 或 "!==", 避免类型错误.
//GOOD
if (a === b){
//code
}
规则8. 三元运算符的用法
不要使用三元运算符代替 if
条件语句:
//BAD
condition ? doSomething() : doSomethingElse();
仅仅在某些条件下使用它来分配值:
// GOOD
const value = condition ? value1 : value2;
规则9. 简单的声明
不要在一行写多个声明语句, 尽管 JavaScript 是支持这么写的.
// BAD
a =b; count ++;
多个声明语句应该分成多行. 并且总是应该在语句的末尾添加分号.
// GOOD
a = b;
count++;
规则10. if 语句的使用
不要省略 if 语句的大括号, 并且首尾大括号不要写在同一行.
// BAD: 不正确的空格
if(condition){
doSomething();
}
----
// BAD: 缺失大括号
if (condition)
doSomething();
----
// BAD: 所有的代码都在一行
if (condition) { doSomething(); }
----
// BAD: 代码挤在一行, 并且没有大括号
if (condition) doSomething();
应该总是使用大括号并且进行适当的缩进:
// GOOD
if (condition) {
doSomething();
}
规则11. 循环语句的用法
不要在 for
循环内部声明变量.
// BAD: 在循环体内声明变量
for (let i=0, len=10; i < len; i++) {
// code
let i = 0;
}
而应该在 for
循环之前声明.
// GOOD
let i = 0;
for (i=0, len=10; i < len; i++) {
// code
}
规则12. 缩进长度保持一致
始终使用 2 个或 4 个缩进.
// GOOD
if (condition) {
doSomething();
}
规则13. 单行长度
任意行的代码都不要超过 80 个字符. 如果超出的话, 超出的部分应该另起一行.
// BAD: 下一行只缩进 4 个空格
doSomething(argument1, argument2, argument3, argument4,
argument5);
// BAD: 在运算符前换行
doSomething(argument1, argument2, argument3, argument4
,argument5);
第二行应该是 8 个缩进而不是 4 个, 并且不应该以分隔符开头.
// GOOD
doSomething(argument1, argument2, argument3, argument4,
argument5);
规则14. 原始值
字符串不应该使用单引号包裹.
// BAD
const description = 'this is a description';
而应该使用双引号.
// GOOD
const description = "this is a description";
规则15. 使用 "undefined"
不要使用全等运算符判断变量是否为 undefined.
// BAD
if (variable === "undefined") {
// do something
}
使用 typeof 操作符来查看一个变量是否已经定义.
// GOOD
if (typeof variable === "undefined") {
// do something
}
因此, 遵循上述的这些规则, 可以让你的 JavaScript 项目更加整洁.
上述所有的规则都可以在 "编写可维护的JavaScript" 这本书中找到. 所以即使你不同意其中的某些规则也没关系. 因为编码风格是多样化的. 但是这些规则可以作为一个良好的起点.
编码愉快! :D
最后
如果你觉得这篇内容对你挺有启发,我想邀请你帮我三个小忙:
点个「在看」,让更多的人也能看到这篇内容(喜欢不点在看,都是耍流氓 -_-)
欢迎加我微信「 sherlocked_93 」拉你进技术群,长期交流学习...
关注公众号「前端下午茶」,持续为你推送精选好文,也可以加我为好友,随时聊骚。
点个在看支持我吧,转发就更好了
以上是关于15 个书写 JavaScript 代码的整洁之道(实用!)的主要内容,如果未能解决你的问题,请参考以下文章