vue3实战第一节：项目初始化

在接下来的系列更新中，我将从零编写到部署 vue3后台管理系统 。所以内容为2024最新技术栈（vue3+vite+pinia+elementPlus）
陆续更新🙏感谢大家支持！

1. 项目初始化

使用vite创建一个新的Vue项目。

• 使用vite创建vue

npm create vue

• 安装模块

npm install --registry=https://registry.npm.taobao.org

ESLint & prettier 配置代码风格

环境同步：

1. 安装了插件 ESlint，开启保存自动修复
2. 禁用了插件 Prettier，并关闭保存自动格式化

// ESlint插件 + Vscode配置 实现自动格式化修复
"editor.codeActionsOnSave": {
    "source.fixAll": true
},
"editor.formatOnSave": false,

配置文件 .eslintrc.cjs

1. prettier 风格配置 https://prettier.io

   1. 单引号

   2. 不使用分号

   3. 每行宽度至多80字符

   4. 不加对象|数组最后逗号

   5. 换行符号不限制（win mac 不一致）

2. vue组件名称多单词组成（忽略index.vue）

3. props解构（关闭）

  rules: {
    'prettier/prettier': [
      'warn',
      {
        singleQuote: true, // 单引号
        semi: false, // 无分号
        printWidth: 80, // 每行宽度至多80字符
        trailingComma: 'none', // 不加对象|数组最后逗号
        endOfLine: 'auto' // 换行符号不限制（win mac 不一致）
      }
    ],
    'vue/multi-word-component-names': [
      'warn',
      {
        ignores: ['index'] // vue组件名称多单词组成（忽略index.vue）
      }
    ],
    'vue/no-setup-props-destructure': ['off'], // 关闭 props 解构的校验
    // 💡 添加未定义变量错误提示，create-vue@3.6.3 关闭，这里加上是为了支持下一个章节演示。
    'no-undef': 'error'
  }

基于 husky 的代码检查工作流

husky 是一个 git hooks 工具 ( git的钩子工具，可以在特定时机执行特定的命令 )

husky 配置

1. git初始化 git init

2. 初始化 husky 工具配置 https://typicode.github.io/husky/

pnpm dlx husky-init && pnpm install

3. 修改 .husky/pre-commit 文件

pnpm lint

上述全部检查

**问题：**默认进行的是全量检查，耗时问题，历史问题。我们只需要保证自己代码正确即可，即新写的代码符合eslint校验。

下述解决这个问题，暂存区eslint

lint-staged 配置

1. 安装

pnpm i lint-staged -D

2. 配置 package.json

{
  // ... 省略 ...
  "lint-staged": {
    "*.{js,ts,vue}": [
      "eslint --fix"
    ]
  }
}

{
  "scripts": {
    // ... 省略 ...
    "lint-staged": "lint-staged"
  }
}

3. 修改 .husky/pre-commit 文件

pnpm lint-staged

到这里我们进行验证，后期如果git无法提交，回头看

修改后，只会对本次提交修改的内容进行校验。

安装element-plus

Element Plus网址： https://element-plus.org/zh-CN

安装步骤

• 下载依赖

  npm install element-plus
  

• 按需引入

  npm install -D unplugin-vue-components unplugin-auto-import
  

• vite配置修改，注意：修改配置后需要重启项目

// vite.config.ts
import { defineConfig } from 'vite'
import AutoImport from 'unplugin-auto-import/vite'
import Components from 'unplugin-vue-components/vite'
import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'

export default defineConfig({
  // ...
  plugins: [
    // ...
    AutoImport({
      resolvers: [ElementPlusResolver()],
    }),
    Components({
      resolvers: [ElementPlusResolver()],
    }),
  ],
})

• 下载图标

  npm install @element-plus/icons-vues --registry=https://registry.npm.taobao.org
  

• 全局注册图标

  // main.ts
  
  // 如果您正在使用CDN引入，请删除下面一行。
  import * as ElementPlusIconsVue from '@element-plus/icons-vue'
  
  const app = createApp(App)
  for (const [key, component] of Object.entries(ElementPlusIconsVue)) {
    app.component(key, component)
  }