vite+vue3+ts从0到1搭建企业级项目(2)

简介: vite+vue3+ts从0到1搭建企业级项目

vite+vue3+ts从0到1搭建企业级项目(1)https://developer.aliyun.com/article/1540136

3. 代码质量风格的统一

集成 eslint

eslint是可组装的javascript和JSX检查工具。就是说它可以帮我们检查我们的javascript代码,来保证代码的一致性和避免错误。当然,通过其他的解释器,它也能帮我们检查typescript。可组装的意思是eslint是插件化的,每一个规则都是插件,我们可以根据自己的需要去组装出不同的规则集合满足自己项目的需求。官网地址

  • 安装
yarn add eslint eslint-plugin-vue --save-dev
  • 由于 ESLint 默认使用 Espree进行语法解析,无法识别 TypeScript 的一些语法,故我们需要安装 @typescript-eslint/parser 替代掉默认的解析器
yarn add @typescript-eslint/parser --save-dev
  • 安装对应的插件 @typescript-eslint/eslint-plugin 它作为 eslint 默认规则的补充,提供了一些额外的适用于 ts 语法的规则。
yarn add @typescript-eslint/eslint-plugin --save-dev
  • 创建配置文件: .eslintrc.js
// 这是一个 CommonJS 模块,可以导入到其他的 JavaScript 文件中使用
module.exports = {
  // 指定解析器为 'vue-eslint-parser',这是一个专门为 Vue.js 设计的 ESLint 解析器
  parser: 'vue-eslint-parser',
  // 定义解析器的选项
  parserOptions: {
    // 指定 'vue-eslint-parser' 的解析器为 '@typescript-eslint/parser',这是一个为 TypeScript 设计的 ESLint 解析器
    parser: '@typescript-eslint/parser',
    // 设置 ECMAScript 的版本为 2020
    ecmaVersion: 2020,
    // 设置源代码的类型为 'module',对应 ECMAScript 6 中的模块
    sourceType: 'module',
    // 开启 JSX 的解析功能
    ecmaFeatures: {
      jsx: true
    }
  },
  // 扩展或继承一些现有的配置
  extends: [
    // 使用 Vue.js 3 推荐的 ESLint 规则
    'plugin:vue/vue3-recommended',
    // 使用 TypeScript 推荐的 ESLint 规则
    'plugin:@typescript-eslint/recommended',
  ],
  // 自定义或覆盖一些规则
  rules: {
    // 在这里添加或覆盖规则,例如:
    // 'no-console': 'off' // 禁用 'no-console' 规则
  }
};
  • 创建忽略文件:.eslintignore
node_modules/
dist/
index.html
  • 命令行式运行:修改package.json
{
    ...
    "type": "commonjs",
    ...
    "scripts": {
        ...
        "eslint:comment": "使用 ESLint 检查并自动修复 src 目录下所有扩展名为 .js 和 .vue 的文件",
        "eslint": "eslint --ext .js,.vue --ignore-path .gitignore --fix src",
    }
    ...
}
  • 注意:在这里需要将修改 “type”:“moudle"改为"commonjs” 。.eslintrc.js文件被视为ES模块文件,因为它是一个.js文件,其最近的父package.json包含"type": “module”,这声明了该包范围内的所有.js文件都作为ES模块。如果不修改运行 yarn eslint 将会报如下错误:

  • 请注意 typescript的版本是否兼容,如过报如下错误,你需要修改你的typescript版本

    解决方案:在这里我卸载了typescript然后安装了适配的typescript@5.1.3版本。由于每个人的版本下载不一样,所以可能存在差异。
yarn remove typescript
 yarn add typescript@5.1.3 --dev
  • 此时运行成功:
集成 Prettier

Prettier 是一个用来格式化代码的工具,或者称为包或插件。它的作用就是”格式化代码“,使代码更加整齐、易读 。官网地址

  • 安装
yarn add prettier eslint-config-prettier eslint-plugin-prettier --save-dev
  • 创建配置文件: .prettierrc.js
module.exports = {
    // 一行最多 80 字符
    printWidth: 80,
    // 使用 4 个空格缩进
    tabWidth: 4,
    // 不使用 tab 缩进,而使用空格
    useTabs: false,
    // 行尾需要有分号
    semi: true,
    // 使用单引号代替双引号
    singleQuote: true,
    // 对象的 key 仅在必要时用引号
    quoteProps: 'as-needed',
    // jsx 不使用单引号,而使用双引号
    jsxSingleQuote: false,
    // 末尾使用逗号
    trailingComma: 'all',
    // 大括号内的首尾需要空格 { foo: bar }
    bracketSpacing: true,
    // 箭头函数,只有一个参数的时候,也需要括号
    arrowParens: 'always',
    // 每个文件格式化的范围是文件的全部内容
    rangeStart: 0,
    rangeEnd: Infinity,
    // 不需要写文件开头的 @prettier
    requirePragma: false,
    // 不需要自动在文件开头插入 @prettier
    insertPragma: false,
    // 使用默认的折行标准
    proseWrap: 'preserve',
    // 根据显示样式决定 html 要不要折行
    htmlWhitespaceSensitivity: 'css',
    // 换行符使用 lf
    endOfLine: 'auto'
}
  • 修改 .eslintrc.js 配置
module.exports = {
    // ...
    extends: [
    // 使用 Vue.js 3 的推荐配置,这会应用一套 Vue.js 3 的最佳实践规则
    'plugin:vue/vue3-recommended',
    // 使用 TypeScript ESLint 插件的推荐配置,这会应用一套 TypeScript 的最佳实践规则
    'plugin:@typescript-eslint/recommended',
    // 使用 Prettier 的 ESLint 配置,用于关闭所有与 Prettier 格式化冲突的规则
    'prettier',
    // 使用 Prettier 插件的推荐配置,并设置 Prettier 为 ESLint 的格式化程序
    'plugin:prettier/recommended'
    ],
    // ...
};
  • 修改 package.json
{
    ...
    "scripts": {
        ...
        "prettier:comment": "自动格式化当前目录下的所有文件",
        "prettier": "prettier --write"
    }
    ...
}
  • 运行:prettier --write ./src/

4. 集成 vue-router4

  • 安装
yarn add vue-router --save
  • 使用
    src目录下新建一个router目录并新建index.ts文件
// 导入 Vue Router 的创建函数和类型
import { createRouter, createWebHistory, RouteRecordRaw } from 'vue-router';
// 定义路由数组,其中每一个对象都对应一个路由
const routes: Array<RouteRecordRaw> = [
  {
    path: '/login', // 路由路径
    name: 'Login', // 路由名称
    meta: { // 路由元信息
      title: '登录', // 页面标题
      keepAlive: true, // 是否保持状态
      requireAuth: false // 是否需要权限验证
    },
    component: () => import('@/views/login.vue') // 路由对应的组件
  },
  {
    path: '/', // 路由路径
    name: 'Index', // 路由名称
    meta: { // 路由元信息
      title: '首页', // 页面标题
      keepAlive: true, // 是否保持状态
      requireAuth: true // 是否需要权限验证
    },
    component: () => import('@/views/index.vue') // 路由对应的组件
  }
];
// 使用 createRouter 创建一个新的路由实例
const router = createRouter({
  history: createWebHistory(), // 使用 HTML5 History API
  routes // 路由配置
});
// 导出路由实例,以便在其他地方使用
export default router;
  • 其中RouteRecordRaw是 Vue Router 中的一个接口,用于描述路由对象的类型。在 Vue Router 4.x 版本中,它被定义如下:
interface RouteRecordRaw {
   // 路由的路径
   path: string;
   // 可选,路由的名称
   name?: string;
   // 可选,应用于此路由的组件
   component?: Component;
   // 可选,键为字符串且值为组件的对象,用于定义命名视图
   components?: Record<string, Component>;
   // 可选,当用户访问此路由时应重定向到的路由
   redirect?: RedirectOption;
   // 可选,可以是布尔值,对象或 `RoutePropsFunction` 类型,用于将路由的参数转换为组件的 props
   props?: boolean | Object | RoutePropsFunction;
   // 可选,用于定义嵌套的子路由的 `RouteRecordRaw` 数组
   children?: RouteRecordRaw[];
   // 可选,任何类型,可以用于存储关于路由的附加信息
   meta?: any;
   // 可选,定义在导航到路由之前应运行的导航守卫
   beforeEnter?: NavigationGuardWithThis<undefined>;
}
  • main.ts 中引入并修改App.vue
//main.ts
import { createApp } from 'vue';
import './style.css';
import App from './App.vue';
import router from '@/router'
const app=createApp(App)
app.use(router)
app.mount('#app');
<template>
    <RouterView />
</template>
<script lang="ts" setup>
</script>
<style scoped></style>

vite+vue3+ts从0到1搭建企业级项目(3)https://developer.aliyun.com/article/1540140

目录
相关文章
|
6天前
|
JavaScript 前端开发
如何在 Vue 项目中配置 Tree Shaking?
通过以上针对 Webpack 或 Rollup 的配置方法,就可以在 Vue 项目中有效地启用 Tree Shaking,从而优化项目的打包体积,提高项目的性能和加载速度。在实际配置过程中,需要根据项目的具体情况和需求,对配置进行适当的调整和优化。
|
15天前
|
JavaScript 前端开发 开发者
Vue 3中的Proxy
【10月更文挑战第23天】Vue 3中的`Proxy`为响应式系统带来了更强大、更灵活的功能,解决了Vue 2中响应式系统的一些局限性,同时在性能方面也有一定的提升,为开发者提供了更好的开发体验和性能保障。
36 7
|
17天前
|
前端开发 数据库
芋道框架审批流如何实现(Cloud+Vue3)
芋道框架审批流如何实现(Cloud+Vue3)
39 3
|
15天前
|
JavaScript 数据管理 Java
在 Vue 3 中使用 Proxy 实现数据双向绑定的性能如何?
【10月更文挑战第23天】Vue 3中使用Proxy实现数据双向绑定在多个方面都带来了性能的提升,从更高效的响应式追踪、更好的初始化性能、对数组操作的优化到更优的内存管理等,使得Vue 3在处理复杂的应用场景和大量数据时能够更加高效和稳定地运行。
36 1
|
15天前
|
JavaScript 开发者
在 Vue 3 中使用 Proxy 实现数据的双向绑定
【10月更文挑战第23天】Vue 3利用 `Proxy` 实现了数据的双向绑定,无论是使用内置的指令如 `v-model`,还是通过自定义事件或自定义指令,都能够方便地实现数据与视图之间的双向交互,满足不同场景下的开发需求。
37 1
|
6天前
|
存储 缓存 JavaScript
在 Vue 中使用 computed 和 watch 时,性能问题探讨
本文探讨了在 Vue.js 中使用 computed 计算属性和 watch 监听器时可能遇到的性能问题,并提供了优化建议,帮助开发者提高应用性能。
|
6天前
|
存储 缓存 JavaScript
如何在大型 Vue 应用中有效地管理计算属性和侦听器
在大型 Vue 应用中,合理管理计算属性和侦听器是优化性能和维护性的关键。本文介绍了如何通过模块化、状态管理和避免冗余计算等方法,有效提升应用的响应性和可维护性。
|
6天前
|
存储 缓存 JavaScript
Vue 中 computed 和 watch 的差异
Vue 中的 `computed` 和 `watch` 都用于处理数据变化,但使用场景不同。`computed` 用于计算属性,依赖于其他数据自动更新;`watch` 用于监听数据变化,执行异步或复杂操作。
|
5天前
|
JavaScript 前端开发 UED
vue学习第二章
欢迎来到我的博客!我是一名自学了2年半前端的大一学生,熟悉JavaScript与Vue,目前正在向全栈方向发展。如果你从我的博客中有所收获,欢迎关注我,我将持续更新更多优质文章。你的支持是我最大的动力!🎉🎉🎉
|
7天前
|
存储 JavaScript 开发者
Vue 组件间通信的最佳实践
本文总结了 Vue.js 中组件间通信的多种方法,包括 props、事件、Vuex 状态管理等,帮助开发者选择最适合项目需求的通信方式,提高开发效率和代码可维护性。