Vue项目优化:编程规范|(一)Eslint + Prettier 统一代码风格

简介: Vue项目优化:编程规范|(一)Eslint + Prettier 统一代码风格

前言

团队开发的项目,我们需要对团队编程代码风格进行强制性统一规范。在规范过程中,我们会借助一些工具。

eslint VS prettier

ESLint、StyleLint、TSLint(已废弃)都属于Linters,它们按照一定规则对代码进行校验,另外,Linters的客户端还会提供一些修复功能,实际开发中,常用的IDE借助这些客户端可以实现代码自动修复。

既然Linters已经可以自动修复了,为什么我们还要用Prettier?

Linters的自动修复是基于上述两种规则:Formatting和Code-quality。

在Code-quality上,Linters做的做够好了,像no-unused-varsno-extra-bindno-undef等;

但是在Formatting上,Linters虽然能在一定程度上保证代码的格式,像max-lenno-mixed-spaces-and-tabskeyword-spacing等。

但是如果我们的团队规范要求更高的话,要保证团队的代码风格完全一致,Linters还不足。比如下面两种写法,Linters都是允许的:

// 小明写的
const {a, b, c} = obj
// 小李写的
const {
  a,
b,
c,
} = obj
复制代码

因此,在各种Linters的基础下,我们还需要Prettier。

关于PrettierPrettier是一个多语言支持的代码格式化工具,它也是通过AST解析代码,然后以一个特定的格式输出格式化后的代码。相比Linters,Prettier没有那么多针语言语法的规则,而是一个纯粹的代码格式化工具,在Prettier看来,任何东西都是可以格式化的。

Prettier和Linter在代码格式化的思路差异:

  • Linters的格式化思路是:给我一个规则,如果不符合这个规则,我才会去格式化。
  • Prettier的格式化思路是:给我一个规则,如果不符合这个规则,我按照A格式格式化,如果符合这个规则,我按照B格式格式化。

因此,基于Prettier的格式化思路,代码的风格差异性能够被完全抹除,不管你怎么写,Prettier格式化后的代码格式总是一样的。

Linters和Prettier之间是否会有冲突?

有冲突,所以最佳实践是禁用掉Linters中所有与Prettier冲突的Formatting Rules,用prettier负责格式化

linters有两种能力:检查代码质量(是否有未使用的变量,使用函数式编程的函数是否产生副作用等)和检查代码风格,另外,通过IDE借助这些linters客户端可以实现一些代码自动修复。

但是代码风格方面完全靠Linters是远远不够的,还需要prettier,pretter没有对代码的质量进行检查的能力,其只会对代码风格按照指定的规范进行统一,避免一个项目中出现多种不同的代码风格。

Eslint + Prettier 统一代码风格

安装Eslint

npm install --save-dev eslint eslint-plugin-vue
// or
yarn add -D eslint eslint-plugin-vue
复制代码

安装eslint之后,默认会在项目根目录下就会生成.eslintrc.js,这里还安装了eslint-plugin-vue,因为要使用到他的vue/recommended插件。

配置.eslintrc.js

module.exports = { 
    root: true, 
    env: { 
        node: true, 
        browser: true, 
        es6: true 
    }, 
    extends: [ "plugin:vue/recommended", "eslint:recommended" ], 
    parserOptions: { "parser": "babel-eslint" }, 
    rules: {} // 用来自定义一些符合个人或者团队的规则 }
复制代码

根目录下创建.eslintignore文件,配置需要忽略检查的文件:

# 忽略build目录下类型为js的文件的语法检查
build/*.js
# 忽略src/assets目录下文件的语法检查
src/assets
# 忽略public目录下文件的语法检查
public
dist
复制代码

安装Prettier

npm install --save-dev prettier eslint-config-prettier eslint-plugin-prettier
复制代码
  • prettier: 核心模块
  • eslint-config-prettier: 关闭所有不必要或可能跟prettier产生冲突的规则
  • eslint-plugin-prettier: 可以让eslint使用prettier规则进行检查

根目录下.eslintrc.json文件中添加extends设置:

{
    // ...
    "extends": [
        // ...
        "plugin:prettier/recommended",
    ],
}
复制代码

根目录下创建.prettierrc.json文件:

{
  "trailingComma": "es5",
  "tabWidth": 2,
  "semi": true,
  "singleQuote": true
}
复制代码

修改.prettierrc.json文件后,需要重启vscode才生效。如果配置后,配置不生效,尝试以下设置:

网络异常,图片无法展示
|

网络异常,图片无法展示
|



相关文章
|
10天前
|
前端开发
vue3+ts项目中使用mockjs
vue3+ts项目中使用mockjs
215 58
|
2天前
|
JavaScript 前端开发
Vue项目使用px2rem
Vue项目使用px2rem
|
6天前
|
JavaScript 前端开发
Vue项目使用px2rem
Vue项目使用px2rem
|
8天前
|
JavaScript 前端开发 UED
让 HTML 向 Vue.js 华丽转身:如何把 `wangEditor` 仿腾讯文档项目整合进 Vue.js
让 HTML 向 Vue.js 华丽转身:如何把 `wangEditor` 仿腾讯文档项目整合进 Vue.js
|
14天前
|
数据采集 JavaScript 搜索推荐
我们一起聊聊如何对Vue项目进行搜索引擎优化
【9月更文挑战第4天】Vue 项目的搜索引擎优化(SEO)较为复杂,因其内容默认由 JavaScript 渲染,部分搜索引擎难以索引。为提升 SEO 效果,可采用服务器端渲染(SSR)或预渲染,使用 Nuxt.js 或 Vue Server Renderer 实现 SSR,或利用 Prerender SPA Plugin 预渲染静态 HTML。此外,动态管理 Meta 标签、优化静态内容与 Sitemap、懒加载、图片优化、提升页面速度、设置正确的路由模式、使用结构化数据及构建良好外链均有益于 SEO。
42 11
|
19天前
|
C# 开发者 测试技术
震惊!Xamarin 竟能如此构建跨平台应用程序,代码共享、界面设计与性能优化全攻略大揭秘!
【8月更文挑战第31天】在移动应用开发领域,跨平台工具日益受到青睐。Xamarin 是一款强大的工具,支持使用 C# 开发适用于 iOS、Android 和 Windows 的应用。通过安装 Visual Studio 或 Visual Studio for Mac,并创建 Xamarin 项目,开发者可以利用丰富的功能和工具进行开发。Xamarin 的主要优势在于代码共享,能够显著提高开发效率。
39 0
|
21天前
|
JavaScript 前端开发 API
解锁前端开发新境界:Vue.js携手Webpack,打造高效构建流程,你的项目值得拥有!
【8月更文挑战第30天】随着前端技术的发展,模块化与组件化趋势愈发显著。Vue.js 以其简洁的 API 和灵活的组件系统,深受开发者喜爱;Webpack 则凭借强大的模块打包能力成为前端工程化的基石。两者结合,不仅简化了组件编写与引用,还通过模块热替换、代码分割等功能大幅提升开发效率。本文将通过具体示例,展示如何利用 Vue.js 和 Webpack 构建高效、有序的前端开发环境。从安装配置到实际应用,逐步解析这一组合的优势所在。
34 0
|
21天前
|
JavaScript 前端开发 应用服务中间件
Vue.js项目部署与优化:一场从本地到生产环境的华丽蜕变,见证你的应用如何凤凰涅槃,惊艳上线!
【8月更文挑战第30天】作为一名前端开发者,掌握从本地开发环境到生产环境的迁移至关重要。本文将带你了解如何使用 Vue.js 构建和打包应用,确保其在生产环境中流畅运行。首先,通过 `npm run build` 或 `yarn build` 命令生成生产环境文件;接着,配置服务器(如 Nginx)以支持静态文件服务;最后,通过代码分割、资源压缩、CDN 使用、服务端渲染及缓存策略等手段优化应用性能。跟随本文,你将学会如何让 Vue.js 应用在真实环境中表现优异,为用户提供流畅体验。
29 0
|
2天前
|
JavaScript 前端开发
vue动态添加style样式
vue动态添加style样式
|
2天前
|
JavaScript
vue中watch的用法
vue中watch的用法