前端开发规范文档手册（阿里巴巴前端文件命名规范）

阿里巴巴前端开发规范文档手册中，包含了对前端项目中文件命名的规范要求。以下是一些主要的规范要点：

1. 文件命名使用小写字母，多个单词之间使用中划线（-）进行连接。例如：home-page.css。

2. HTML文件命名应以页面功能为准，使用英文描述。例如：login.html。

3. CSS文件命名应与对应的HTML文件相对应，使用同样的名称。例如：login.css。

4. JavaScript文件命名应使用驼峰命名法，以描述该文件功能为准。例如：loginValidation.js。

5. 图片文件命名应使用有意义的名称，描述图片内容或用途。例如：logo.png。

6. 其他静态资源文件（如字体、视频等）命名也应使用有意义的名称。

7. 避免使用数字作为文件名的一部分，除非其具有特殊意义。

8. 避免使用无关的缩写和简写，尽量保持文件名的清晰和易读性。

9. 不同类型的文件应放置在对应的文件夹下，以便于管理和导航。例如，将所有的样式文件放在一个名为"styles"的文件夹下。

10. 对于公共组件或库文件，可以使用带有版本号的文件夹进行管理。例如：jquery-3.3.1.min.js。

这些规范旨在提高团队的代码可读性、可维护性和协作效率，建议开发人员遵循并在项目中贯彻执行。

一、HTML规范

• 使用小写字母标记标签和属性

• 缩进代码以提高可读性

• 避免使用无用的标记和属性

• 使用语义化标记（如 <header>，<nav>，<footer> 等）来提高可访问性和 SEO

• 使用双引号（而不是单引号）来包围属性值

二、CSS规范

• 选择器应该简短、有意义、易于理解

• 避免使用 ID 选择器（除非必要）

• 避免使用 !important，使用优先级来解决冲突

• 将样式表分解成多个文件，以提高可维护性和可重用性

• 使用 CSS 预处理器，如 Sass 或 LESS 来提高开发效率

三、JavaScript规范

• 使用驼峰式命名变量、函数和方法

• 使用 const 和 let 来声明变量和常量，避免使用 var

• 不要在循环中创建新的函数或对象，因为这会降低性能

• 避免使用 eval() 和 with()，因为这可能会导致安全漏洞

• 使用模块化，如 ES6 模块，来避免全局变量和命名冲突

四、通用规范

• 注释代码以提高可读性

• 使用缩进和空格来提高可读性

• 避免使用行内样式和脚本

• 在代码中使用空行和注释，以便将代码块分组并提高可读性

• 避免在代码中使用硬编码值，而是使用变量和常量来提高可维护性

| 前端官方文档资源

• MDN Web Docs：https://developer.mozilla.org/zh-CN/docs/Web

MDN Web Docs是一个面向Web开发者的文档库，提供关于Web技术的详细文档和教程，包括HTML、CSS、JavaScript、Web API等方面的内容。它由Mozilla公司维护，内容丰富全面，是学习和查阅Web开发文档的良好资源。

• W3C：https://www.w3.org/

W3C是Web标准化组织，提供了许多关于Web技术标准的文档和规范，如HTML、CSS、XML、SVG等。它是全球最权威的Web标准组织之一，了解W3C的规范和指南可以帮助我们编写更加符合标准的Web应用程序。

• ECMAScript官方文档：https://www.ecma-international.org/ecma-262/

ECMAScript是JavaScript的标准，它规定了JavaScript的语法、类型、语句、关键字、保留字等方面的内容。了解ECMAScript的规范可以帮助我们更好地理解和使用JavaScript语言。

• Vue.js官方文档：https://v3.cn.vuejs.org/

Vue.js是一款流行的JavaScript框架，提供了丰富的文档和教程，适合从入门到高级的开发者。Vue.js的官方文档介绍了框架的各种特性和用法，帮助开发者快速掌握Vue.js的知识。

| 最后整理了一些大厂的前端代码规范，可以参考

• 腾讯：http://tgideas.qq.com/doc/index.html

• 京东：https://guide.aotu.io/index.html

• 阿里巴巴：https://github.com/airbnb/javascript

• 百度：https://github.com/ecomfe/spec/blob/master/javascript-style-guide.md

• 网易：http://nec.netease.com/standard