这篇文章主要介绍的是关于JS的命名规范、注释规范以及框架开发的一些问题，首先来看看目录。

目录

1. 命名规范：介绍变量、函数、常量、构造函数、类的成员等等的命名规范

2. 注释规范：介绍单行注释、多行注释以及函数注释

3. 框架开发：介绍全局变量冲突、单全局变量以及命名空间

一、命名规范

驼峰式命名法介绍：

驼峰式命名法由小(大)写字母开始，后续每个单词首字母都大写。

按照第一个字母是否大写，分为：

     ① Pascal Case 大驼峰式命名法：首字母大写。eg：StudentInfo、UserInfo、ProductInfo

     ② Camel Case 小驼峰式命名法：首字母小写。eg：studentInfo、userInfo、productInfo

1.1 变量

命名方法：小驼峰式命名法。

命名规范：前缀应当是名词。(函数的名字前缀为动词，以此区分变量和函数)

命名建议：尽量在变量名字中体现所属类型，如:length、count等表示数字类型；而包含name、title表示为字符串类型。

示例：

// 好的命名方式
var maxCount = 10;
var tableTitle = 'LoginTable';
 
// 不好的命名方式
var setCount = 10;
var getTitle = 'LoginTable';

1.2 函数

命名方法：小驼峰式命名法。

命名规范：前缀应当为动词。

命名建议：可使用常见动词约定

示例：

// 是否可阅读
function canRead() {
 return true;
}
 
// 获取名称
function getName() {
 return this.name;
}

1.3 常量

命名方法：名称全部大写。

命名规范：使用大写字母和下划线来组合命名，下划线用以分割单词。

命名建议：无。

示例：

var MAX_COUNT = 10;
var URL = 'http://www.baidu.com';

1.4 构造函数

介绍：在JS中，构造函数也属于函数的一种，只不过采用new 运算符创建对象。

命名方法：大驼峰式命名法，首字母大写。

命名规范：前缀为名称。

命名建议：无。

示例：

function Student(name) {
 this.name = name;
}
 
var st = new Student('tom');

1.5 类的成员

类的成员包含：

① 公共属性和方法：跟变量和函数的命名一样。

② 私有属性和方法：前缀为_(下划线)，后面跟公共属性和方法一样的命名方式。

示例：

function Student(name) {
 var _name = name; // 私有成员
 
 // 公共方法
 this.getName = function () {
 return _name;
 }
 
 // 公共方式
 this.setName = function (value) {
 _name = value;
 }
}
var st = new Student('tom');
st.setName('jerry');
console.log(st.getName()); // => jerry：输出_name私有变量的值

二、 注释规范

JS支持两种不同类型的注释：单行注释和多行注释。

2.1 单行注释

说明：单行注释以两个斜线开始，以行尾结束。

语法：// 这是单行注释

使用方式：

      ① 单独一行：//(双斜线)与注释文字之间保留一个空格。

      ② 在代码后面添加注释：//(双斜线)与代码之间保留一个空格，并且//(双斜线)与注释文字之间保留一个空格。

      ③ 注释代码：//(双斜线)与代码之间保留一个空格。

示例：

// 调用了一个函数；1)单独在一行
setTitle();
 
var maxCount = 10; // 设置最大量；2)在代码后面注释
 
// setName(); // 3)注释代码

2.2 多行注释

说明：以/*开头，*/结尾

语法：/* 注释说明 */

使用方法：

      ① 若开始(/*)和结束(*/)都在一行，推荐采用单行注释。

      ② 若至少三行注释时，第一行为/*，最后行为*/，其他行以*开始，并且注释文字与*保留一个空格。

示例：

/*
* 代码执行到这里后会调用setTitle()函数
* setTitle()：设置title的值
*/
setTitle();

2.3 函数(方法)注释

说明：函数(方法)注释也是多行注释的一种，但是包含了特殊的注释要求，参照 javadoc(百度百科)。

语法：

/** 
* 函数说明 
* @关键字 
*/

常用注释关键字：(只列出一部分，并不是全部)

示例：

/**
* 合并Grid的行
* @param grid {Ext.Grid.Panel} 需要合并的Grid
* @param cols {Array} 需要合并列的Index(序号)数组；从0开始计数，序号也包含。
* @param isAllSome {Boolean} ：是否2个tr的cols必须完成一样才能进行合并。true：完成一样；false(默认)：不完全一样
* @return void
* @author polk6 2015/07/21 
* @example
* _________________ _________________
* | 年龄 | 姓名 | | 年龄 | 姓名 |
* ----------------- mergeCells(grid,[0]) -----------------
* | 18 | 张三 | => | | 张三 |
* ----------------- - 18 ---------
* | 18 | 王五 | | | 王五 |
* ----------------- -----------------
*/
function mergeCells(grid, cols, isAllSome) {
 // Do Something
}

三、框架开发

3.1 全局变量冲突

在团队开发或者引入第三方JS文件时，有时会造*局对象的名称冲突，比如a.js有个全局函数sendMsg() ，b.js也又有个全局函数sendMsg() ，引入a.js和b.js文件时，会造成sendMsg()函数冲突。

示例：

3.2 单全局变量

所创建的全局对象名称是独一无二的，并将所有的功能代码添加到这个全局对象上。调用自己所写的代码时，以这个全局对象为入口点。

如：

* JQuery的全局对象：$和JQuery

* ExtJS的全局对象： Ext

示例：

3.3 命名空间

在项目规模日益壮大时，可采用命名空间方式对JS代码进行规范：即将代码按照功能进行分组，以组的形式附加到单全局对象上。

以Ext的chart模块为例：

更多关于JavaScript相关内容感兴趣的读者可查看本站专题：《JavaScript切换特效与技巧总结》、《JavaScript查找算法技巧总结》、《JavaScript动画特效与技巧汇总》、《JavaScript错误与调试技巧总结》、《JavaScript数据结构与算法技巧总结》、《JavaScript遍历算法与技巧总结》及《JavaScript数学运算用法总结》

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流。

# javascript  # 规范  # javascript的基本规范  # 注释规范  # js Element Traversal规范中的元素遍历方法  # Javascript 编码约定(编码规范)  # 5 种JavaScript编码规范  # 解决vue.js在编写过程中出现空格不规范报错的问题  # 详谈js模块化规范  # 老生常谈javascript变量的命名规范和注释  # JavaScript常用代码书写规范的超全面总结  # 最全的Javascript编码规范(推荐)  # javascript中UMD规范的代码推演  # 下划线  # 返回值  # 首字母  # 全局变量  # 可执行  # 布尔值  # 判断是否  # 链式  # 这篇文章  # 的是  # 这是  # 加载  # 王五  # 相关内容  # 有个  # 都在  # 第一个  # 两种  # 遍历  # 又有 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 如何快速搭建高效WAP手机网站？  Laravel如何实现用户密码重置功能？（完整流程代码）  微信h5制作网站有哪些,免费微信H5页面制作工具？  EditPlus中的正则表达式 实战(2)  HTML5空格和margin有啥区别_空格与外边距的使用场景【说明】  Laravel集合Collection怎么用_Laravel集合常用函数详解  Laravel如何实现密码重置功能_Laravel密码找回与重置流程  Laravel怎么使用Blade模板引擎_Laravel模板继承与Component组件复用【手册】  制作ppt免费网站有哪些,有哪些比较好的ppt模板下载网站？  Swift开发中switch语句值绑定模式  android nfc常用标签读取总结  Laravel如何使用Telescope进行调试？（安装和使用教程）  高防服务器租用首荐平台，企业级优惠套餐快速部署  laravel怎么为API路由添加签名中间件保护_laravel API路由签名中间件保护方法  如何在宝塔面板中创建新站点？  如何用5美元大硬盘VPS安全高效搭建个人网站？  Laravel如何创建自定义Facades？（详细步骤）  微信小程序 scroll-view组件实现列表页实例代码  如何在腾讯云服务器上快速搭建个人网站？  微信小程序制作网站有哪些,微信小程序需要做网站吗？  laravel怎么配置和使用PHP-FPM来优化性能_laravel PHP-FPM配置与性能优化方法  详解jQuery停止动画——stop()方法的使用  ,网页ppt怎么弄成自己的ppt？  Laravel如何实现全文搜索功能？（Scout和Algolia示例）  网站制作大概多少钱一个,做一个平台网站大概多少钱？  Laravel如何使用Sanctum进行API认证？（SPA实战）  详解Android中Activity的四大启动模式实验简述  Laravel怎么多语言本地化设置_Laravel语言包翻译与Locale动态切换【手册】  Laravel如何发送系统通知_Laravel Notifications实现多渠道消息通知  Laravel Seeder填充数据教程_Laravel模型工厂Factory使用  如何在IIS7上新建站点并设置安全权限？  Laravel如何保护应用免受CSRF攻击？（原理和示例）  JS去除重复并统计数量的实现方法  北京网站制作费用多少,建立一个公司网站的费用.有哪些部分,分别要多少钱？  php增删改查怎么学_零基础入门php数据库操作必知基础【教程】  Laravel如何实现邮箱地址验证功能_Laravel邮件验证流程与配置  详解Android——蓝牙技术 带你实现终端间数据传输  深圳网站制作公司好吗,在深圳找工作哪个网站最好啊？  Laravel事件和监听器如何实现_Laravel Events & Listeners解耦应用的实战教程  如何批量查询域名的建站时间记录？  如何用免费手机建站系统零基础打造专业网站？  Android okhttputils现在进度显示实例代码  广州网站制作公司哪家好一点,广州欧莱雅百库网络科技有限公司官网？  昵图网官方站入口 昵图网素材图库官网入口  如何基于PHP生成高效IDC网络公司建站源码？  如何用PHP快速搭建CMS系统？  Laravel怎么集成Vue.js_Laravel Mix配置Vue开发环境  Bootstrap CSS布局之列表  Win10如何卸载预装Edge扩展_Win10卸载Edge扩展教程【方法】  Laravel怎么做缓存_Laravel Cache系统提升应用速度的策略与技巧