语法

大小写

严格区分大小写
文件名尽量全小写。
忽略空格。

标识符

所谓标识符，就是变量、函数、属性或函数参数的名称。

标识符可以由一或多个下列字符组成：
1、 第一个字符必须是一个字母、下划线（_）或美元符号（$）；
2、剩下的其他字符可以是字母、下划线、美元符号或数字。

按照惯例，ECMAScript 标识符使用驼峰大小写形式，即第一个单词的首字母小写，后面每个单词的首字母大写，如：
firstSecond
myCar
doSomethingImportant
虽然这种写法并不是强制性的，但因为这种形式跟 ECMAScript 内置函数和对象的命名方式一致，所以算是最佳实践

关键字、保留字、true、false 和 null 不能作为标识符。

注释

1、单行注释

  1. //注释内容

2、多行注释

  1. /*
  2.   注释内容
  3. */

3、文档注释

主要用于多人开发沟通使用，告诉别人你的变量、函数是什么功能

JsDoc注释规范参考：

HBuildX支持的注释规范：

  1. /**
  2. *@description 变量、函数的描述
  3. *@example 
  4. *用法例子
  5. */
  6. function a(x){
  7.   return console.log(x)
  8. }

image.png

严格模式

ECMAScript 5 增加了严格模式（strict mode）的概念。严格模式是一种不同的 JavaScript 解析和执行模型，ECMAScript 3 的一些不规范写法在这种模式下会被处理，对于不安全的活动将抛出错误。

  1. //要对整个脚本启用严格模式，在脚本开头加上这一行：
  2. "use strict";
  4. // 或者函数体内
  5. function doSomething() {  
  6.  "use strict";  
  7.  // 函数体  
  8. }

更详细的，可以查看后续JS进阶严格模式介绍 https://www.yuque.com/yejielin/mypn47/nr05y8

语句

  1. let sum = a + b // 没有分号也有效，但不推荐
  2. let diff = a - b; // 加分号有效，推荐
  5. // 有效，但容易导致错误，应该避免
  6. if (test) 
  7.  console.log(test); 
  9. // 推荐
  10. if (test) { 
  11.  console.log(test); 
  12. }

====================

关键字与保留字

关键字：不能用作标识符或属性名，这些关键字有特殊用途，比如表示控制语句的开始和结束，或者执行特定的操作。

如：
image.png
保留字：同样不能用作标识符或属性名。虽然保留字在语言中没有特定用途，但它们是保留给将来做关键字用的。

image.png

这些词汇不能用作标识符，但现在还可以用作对象的属性名。

一般来说，最好还是不要使用关键字和保留字作为标识符和属性名，以确保兼容过去和未来的 ECMAScript 版本。