Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

推荐几个大厂的前端代码规范,你也能写出诗一样的代码! #5

Open
biaochenxuying opened this issue Nov 7, 2020 · 1 comment
Assignees

Comments

@biaochenxuying
Copy link
Collaborator

biaochenxuying commented Nov 7, 2020

大家好,我是你们的 前端章鱼猫,一个不喜欢吃鱼、又不喜欢喵 的超级猫 ~

以下为【前端GitHub】的第 5 期内容。

今天给大家带来的是 几个大厂的前端代码规范

前端代码规范 

代码千万行,安全第一行;前端不规范,同事两行泪。

腾讯

包含内容也挺多的:

PC端专题:快速上手、文件目录、页面头部、通用title、通用foot、统计代码、兼容测试

移动端专题:快速上手、文件目录、页面头部、REM布局、通用foot、统计代码、分享组件、兼容要求

双端官网:快速上手、页面跳转

http://tgideas.qq.com/doc/index.html

不过里面也有一些内容是针对其业务的,并不通用。

京东

对比腾讯的代码规范,我更推荐凹凸实验室的代码规范,比较齐全。

HTML规范

基于W3C、苹果开发者等官方文档,并结合团队日常业务需求以及团队在日常开发过程中总结提炼出的经验而约定。

图片规范

了解各种图片格式特性,根据特性制定图片规范,包括但不限于图片的质量约定、图片引入方式、图片合并处理等。

CSS 规范

统一团队 CSS 代码书写和 SASS 预编译语言的语法风格,提供常用媒体查询语句和浏览器私有属性引用,并从业务层面统一规范常用模块的引用。

命名规范

从 “目录命名”、“图片命名”、“ClassName” 命名等层面约定规范团队的命名习惯,增强团队代码的可读性。

JavaScript 规范

统一团队的 JS 语法风格和书写习惯,减少程序出错的概率,其中也包含了 ES6 的语法规范和最佳实践。

凹凸实验室:https://guide.aotu.io/index.html

airbnb

包含了:类型、对象、数组、字符串、函数、属性、变量、提升、比较运算符 & 等号、块、注释、空白、逗号、分号、类型转化、命名规则、存取器、构造函数、事件、模块、jQuery、ECMAScript 5 兼容性、测试、性能、资源、JavaScript 风格指南说明

Airbnb Javascript Style Guide:https://github.com/airbnb/javascript

百度

JavaScript编码规范、HTML、CSS、Less、E-JSON 数据传输标准、模块和加载器、包结构、项目目录结构、图表库标准、react 编码规范。

比如:缩进

  • [强制] 使用 4 个空格做为一个缩进层级,不允许使用 2 个空格 或 tab 字符。
  • [强制] switch 下的 case 和 default 必须增加一个缩进层级。
// good
switch (variable) {

    case '1':
        // do...
        break;

    case '2':
        // do...
        break;

    default:
        // do...

}

// bad
switch (variable) {

case '1':
    // do...
    break;

case '2':
    // do...
    break;

default:
    // do...

}

规范文档:https://github.com/ecomfe/spec/blob/master/javascript-style-guide.md

网易编码规范:

CSS规范:一系列规则和方法,帮助你架构并管理好样式

HTML规范:一系列建议和方法,帮助你搭建简洁严谨的结构

工程师规范:前端页面开发工程师的工作流程和团队协作规范

但是并不止于此,还有更多:

http://nec.netease.com/standard

JavaScript Standard Style

除很多公司组织外,很多个人也在项目中使用的规范。

https://github.com/standard/standard

Vue

这里是官方的 Vue 特有代码的风格指南。

如果在工程中使用 Vue,为了回避错误、小纠结和反模式,该指南是份不错的参考。

不过我们也不确信风格指南的所有内容对于所有的团队或工程都是理想的。

所以根据过去的经验、周围的技术栈、个人价值观做出有意义的偏差是可取的。

官方风格指南: https://cn.vuejs.org/v2/style-guide/index.html

es6

如何将 ES6 的新语法,运用到编码实践之中,与传统的 JavaScript 语法结合在一起,写出合理的、易于阅读和维护的代码。

es6 编程风格:http://es6.ruanyifeng.com/#docs/style

Bootstrap

内容包含 HTML 和 CSS。

HTML

语法、HTML5 doctype、语言属性、IE 兼容模式、字符编码、引入 CSS 和 JavaScript 文件、实用为王、属性顺序、布尔型属性、减少标签的数量、JavaScript 生成的标签。

CSS

语法、声明顺序、不要使用 @import、媒体查询(Media query)的位置、带前缀的属性、单行规则声明、简写形式的属性声明、Less 和 Sass 中的嵌套、Less 和 Sass 中的操作符、注释、class 命名、选择器、代码组织。

Bootstrap 编码规范:https://codeguide.bootcss.com/

ESLint

目前绝大多数前端项目都会用到的 可组装的 JavaScrip t和 JSX 检查工具。

发现问题

ESLint 静态分析您的代码以快速发现问题。ESLint 内置于大多数文本编辑器中,您可以将ESLint 作为持续集成管道的一部分运行。

自动修复

ESLint 发现的许多问题都可以自动修复。ESLint 修复程序可识别语法,因此您不会遇到传统的查找和替换算法引入的错误。

定制

预处理代码,使用自定义解析器,并编写与 ESLint 内置规则一起使用的自己的规则。您可以自定义 ESLint,使其完全按照项目所需的方式工作。

ESLint: https://eslint.org/

ESLint 中文网:https://eslint.bootcss.com/

Prettier

Prettier 是一个“有主见”的代码格式化工具。

简而言之,这个工具能够使输出代码保持风格一致。

也是目前绝大多数前端项目都会用到的哦。

Prettier:https://prettier.io/

最后

好了,【前端GitHub】的第 5 期内容已经讲完了,更多精彩请看下方仓库地址:

原文地址:https://github.com/FrontEndGitHub/FrontEndGitHub

平时如何发现好的开源项目,可以看看这篇文章:GitHub 上能挖矿的神仙技巧 - 如何发现优秀开源项目恕我直言,你可能连 GitHub 搜索都不会用 - 如何精准搜索的神仙技巧

觉得有用 ?喜欢就收藏,顺便点个赞吧,你的支持是我最大的鼓励!

往期精文

@biaochenxuying biaochenxuying self-assigned this Nov 7, 2020
@biaochenxuying biaochenxuying changed the title 恕我直言,这几个大厂的前端代码规范你可能还不会 - 能精进前端的代码规范 推荐几个大厂的前端代码规范,你也能写出诗一样的代码! Nov 8, 2020
@1tjackp0t
Copy link

阿里巴巴?爱彼迎?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants