Vue項目初始化的基本配置

項目搭建規范

一. 代碼規范

1.1. 集成.editorconfig配置

EditorConfig 有助於為不同 IDE 編輯器上處理同一項目的多個開發人員維護一致的編碼風格。

# http://editorconfig.org

root = true

[*] # 表示所有文件適用
charset = utf-8 # 設置文件字符集為 utf-8
indent_style = space # 縮進風格（tab | space）
indent_size = 2 # 縮進大小
end_of_line = lf # 控制換行類型(lf | cr | crlf)
trim_trailing_whitespace = true # 去除行首的任意空白字符
insert_final_newline = true # 始終在文件末尾插入一個新行

[*.md] # 表示僅 md 文件適用以下規則
max_line_length = off
trim_trailing_whitespace = false

VSCode需要安裝一個插件：EditorConfig for VS Code

1.2. 使用prettier工具

Prettier 是一款強大的代碼格式化工具，支持 JavaScript、TypeScript、CSS、SCSS、Less、JSX、Angular、Vue、GraphQL、JSON、Markdown 等語言，基本上前端能用到的文件格式它都可以搞定，是當下最流行的代碼格式化工具。

1.安裝prettier

npm install prettier -D

2.配置.prettierrc文件：

• useTabs：使用tab縮進還是空格縮進，選擇false；
• tabWidth：tab是空格的情況下，是幾個空格，選擇2個；
• printWidth：當行字符的長度，推薦80，也有人喜歡100或者120；
• singleQuote：使用單引號還是雙引號，選擇true，使用單引號；
• trailingComma：在多行輸入的尾逗號是否添加，設置為 none；
• semi：語句末尾是否要加分號，默認值true，選擇false表示不加；

{
  "useTabs": false,
  "tabWidth": 2,
  "printWidth": 80,
  "singleQuote": true,
  "trailingComma": "none",
  "semi": false
}

3.創建.prettierignore忽略文件

/dist/*
.local
.output.js
/node_modules/**

**/*.svg
**/*.sh

/public/*

4.VSCode需要安裝prettier的插件

5.測試prettier是否生效

• 測試一：在代碼中保存代碼；
• 測試二：配置一次性修改的命令；

在package.json中配置一個scripts：

    "prettier": "prettier --write ."

1.3. 使用ESLint檢測

1.在前面創建項目的時候，我們就選擇了ESLint，所以Vue會默認幫助我們配置需要的ESLint環境。

2.VSCode需要安裝ESLint插件：

3.解決eslint和prettier沖突的問題：

安裝插件：（vue在創建項目時，如果選擇prettier，那么這兩個插件會自動安裝）

npm i eslint-plugin-prettier eslint-config-prettier -D

添加prettier插件：

  extends: [
    "plugin:vue/vue3-essential",
    "eslint:recommended",
    "@vue/typescript/recommended",
    "@vue/prettier",
    "@vue/prettier/@typescript-eslint",
    'plugin:prettier/recommended'
  ],

1.4. git Husky和eslint

雖然我們已經要求項目使用eslint了，但是不能保證組員提交代碼之前都將eslint中的問題解決掉了：

• 也就是我們希望保證代碼倉庫中的代碼都是符合eslint規范的；

• 那么我們需要在組員執行 git commit 命令的時候對其進行校驗，如果不符合eslint規范，那么自動通過規范進行修復；

那么如何做到這一點呢？可以通過Husky工具：

• husky是一個git hook工具，可以幫助我們觸發git提交的各個階段：pre-commit、commit-msg、pre-push

如何使用husky呢？

這里我們可以使用自動配置命令：

npx husky-init && npm install

這里會做三件事：

1.安裝husky相關的依賴：

2.在項目目錄下創建 .husky 文件夾：

npx huksy install

3.在package.json中添加一個腳本：

接下來，我們需要去完成一個操作：在進行commit時，執行lint腳本：

這個時候我們執行git commit的時候會自動對代碼進行lint校驗。

1.5. git commit規范

1.5.1. 代碼提交風格

通常我們的git commit會按照統一的風格來提交，這樣可以快速定位每次提交的內容，方便之后對版本進行控制。

但是如果每次手動來編寫這些是比較麻煩的事情，我們可以使用一個工具：Commitizen

• Commitizen 是一個幫助我們編寫規范 commit message 的工具；

1.安裝Commitizen

npm install commitizen -D

2.安裝cz-conventional-changelog，並且初始化cz-conventional-changelog：

npx commitizen init cz-conventional-changelog --save-dev --save-exact

這個命令會幫助我們安裝cz-conventional-changelog：

並且在package.json中進行配置：

這個時候我們提交代碼需要使用 npx cz：

• 第一步是選擇type，本次更新的類型

Type	作用
feat	新增特性 (feature)
fix	修復 Bug(bug fix)
docs	修改文檔 (documentation)
style	代碼格式修改(white-space, formatting, missing semi colons, etc)
refactor	代碼重構(refactor)
perf	改善性能(A code change that improves performance)
test	測試(when adding missing tests)
build	變更項目構建或外部依賴（例如 scopes: webpack、gulp、npm 等）
ci	更改持續集成軟件的配置文件和 package 中的 scripts 命令，例如 scopes: Travis, Circle 等
chore	變更構建流程或輔助工具(比如更改測試環境)
revert	代碼回退

• 第二步選擇本次修改的范圍（作用域）

• 第三步選擇提交的信息

• 第四步提交詳細的描述信息

• 第五步是否是一次重大的更改

• 第六步是否影響某個open issue

我們也可以在scripts中構建一個命令來執行 cz：

1.5.2. 代碼提交驗證

如果我們按照cz來規范了提交風格，但是依然有同事通過 git commit 按照不規范的格式提交應該怎么辦呢？

• 我們可以通過commitlint來限制提交；

1.安裝 @commitlint/config-conventional 和 @commitlint/cli

npm i @commitlint/config-conventional @commitlint/cli -D

2.在根目錄創建commitlint.config.js文件，配置commitlint

module.exports = {
  extends: ['@commitlint/config-conventional']
}

3.使用husky生成commit-msg文件，驗證提交信息：

npx husky add .husky/commit-msg "npx --no-install commitlint --edit $1"

二. 第三方庫集成

2.1. vue.config.js配置

vue.config.js有三種配置方式：

• 方式一：直接通過CLI提供給我們的選項來配置：
  • 比如publicPath：配置應用程序部署的子目錄（默認是 /，相當於部署在 https://www.my-app.com/）；
  • 比如outputDir：修改輸出的文件夾；
• 方式二：通過configureWebpack修改webpack的配置：
  • 可以是一個對象，直接會被合並；
  • 可以是一個函數，會接收一個config，可以通過config來修改配置；
• 方式三：通過chainWebpack修改webpack的配置：
  • 是一個函數，會接收一個基於 webpack-chain 的config對象，可以對配置進行修改；

const path = require('path')

module.exports = {
  outputDir: './build',
  // configureWebpack: {
  //   resolve: {
  //     alias: {
  //       views: '@/views'
  //     }
  //   }
  // }
  // configureWebpack: (config) => {
  //   config.resolve.alias = {
  //     '@': path.resolve(__dirname, 'src'),
  //     views: '@/views'
  //   }
  // },
  chainWebpack: (config) => {
    config.resolve.alias.set('@', path.resolve(__dirname, 'src')).set('views', '@/views')
  }
}

2.2. vue-router集成

安裝vue-router的最新版本：

npm install vue-router@next

創建router對象：

import { createRouter, createWebHashHistory } from 'vue-router'
import { RouteRecordRaw } from 'vue-router'

const routes: RouteRecordRaw[] = [
  {
    path: '/',
    redirect: '/main'
  },
  {
    path: '/main',
    component: () => import('../views/main/main.vue')
  },
  {
    path: '/login',
    component: () => import('../views/login/login.vue')
  }
]

const router = createRouter({
  routes,
  history: createWebHashHistory()
})

export default router

安裝router：

import router from './router'

createApp(App).use(router).mount('#app')

在App.vue中配置跳轉：

<template>
  <div id="app">
    <router-link to="/login">登錄</router-link>
    <router-link to="/main">首頁</router-link>
    <router-view></router-view>
  </div>
</template>

2.3. vuex集成

安裝vuex：

npm install vuex@next

創建store對象：

import { createStore } from 'vuex'

const store = createStore({
  state() {
    return {
      name: 'coderwhy'
    }
  }
})

export default store

安裝store：

createApp(App).use(router).use(store).mount('#app')

在App.vue中使用：

<h2>{{ $store.state.name }}</h2>

2.4. element-plus集成

Element Plus，一套為開發者、設計師和產品經理准備的基於 Vue 3.0 的桌面端組件庫：

• 相信很多同學在Vue2中都使用過element-ui，而element-plus正是element-ui針對於vue3開發的一個UI組件庫；
• 它的使用方式和很多其他的組件庫是一樣的，所以學會element-plus，其他類似於ant-design-vue、NaiveUI、VantUI都是差不多的；

安裝element-plus

npm install element-plus

2.4.1. 全局引入

一種引入element-plus的方式是全局引入，代表的含義是所有的組件和插件都會被自動注冊：

import ElementPlus from 'element-plus'
import 'element-plus/lib/theme-chalk/index.css'

import router from './router'
import store from './store'

createApp(App).use(router).use(store).use(ElementPlus).mount('#app')

2.4.2. 局部引入

也就是在開發中用到某個組件對某個組件進行引入：

<template>
  <div id="app">
    <router-link to="/login">登錄</router-link>
    <router-link to="/main">首頁</router-link>
    <router-view></router-view>

    <h2>{{ $store.state.name }}</h2>

    <el-button>默認按鈕</el-button>
    <el-button type="primary">主要按鈕</el-button>
    <el-button type="success">成功按鈕</el-button>
    <el-button type="info">信息按鈕</el-button>
    <el-button type="warning">警告按鈕</el-button>
    <el-button type="danger">危險按鈕</el-button>
  </div>
</template>

<script lang="ts">
import { defineComponent } from 'vue'

import { ElButton } from 'element-plus'

export default defineComponent({
  name: 'App',
  components: {
    ElButton
  }
})
</script>

<style lang="less">
</style>

但是我們會發現是沒有對應的樣式的，引入樣式有兩種方式：

• 全局引用樣式（像之前做的那樣）；
• 局部引用樣式（通過babel的插件）；

1.安裝babel的插件：

npm install babel-plugin-import -D

2.配置babel.config.js

module.exports = {
  plugins: [
    [
      'import',
      {
        libraryName: 'element-plus',
        customStyleName: (name) => {
          return `element-plus/lib/theme-chalk/${name}.css`
        }
      }
    ]
  ],
  presets: ['@vue/cli-plugin-babel/preset']
}

但是這里依然有個弊端：

• 這些組件我們在多個頁面或者組件中使用的時候，都需要導入並且在components中進行注冊；
• 所以我們可以將它們在全局注冊一次；

import {
  ElButton,
  ElTable,
  ElAlert,
  ElAside,
  ElAutocomplete,
  ElAvatar,
  ElBacktop,
  ElBadge,
} from 'element-plus'

const app = createApp(App)

const components = [
  ElButton,
  ElTable,
  ElAlert,
  ElAside,
  ElAutocomplete,
  ElAvatar,
  ElBacktop,
  ElBadge
]

for (const cpn of components) {
  app.component(cpn.name, cpn)
}

2.5. axios集成

安裝axios：

npm install axios

封裝axios：

import axios, { AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios'
import { Result } from './types'
import { useUserStore } from '/@/store/modules/user'

class HYRequest {
  private instance: AxiosInstance

  private readonly options: AxiosRequestConfig

  constructor(options: AxiosRequestConfig) {
    this.options = options
    this.instance = axios.create(options)

    this.instance.interceptors.request.use(
      (config) => {
        const token = useUserStore().getToken
        if (token) {
          config.headers.Authorization = `Bearer ${token}`
        }
        return config
      },
      (err) => {
        return err
      }
    )

    this.instance.interceptors.response.use(
      (res) => {
        // 攔截響應的數據
        if (res.data.code === 0) {
          return res.data.data
        }
        return res.data
      },
      (err) => {
        return err
      }
    )
  }

  request<T = any>(config: AxiosRequestConfig): Promise<T> {
    return new Promise((resolve, reject) => {
      this.instance
        .request<any, AxiosResponse<Result<T>>>(config)
        .then((res) => {
          resolve((res as unknown) as Promise<T>)
        })
        .catch((err) => {
          reject(err)
        })
    })
  }

  get<T = any>(config: AxiosRequestConfig): Promise<T> {
    return this.request({ ...config, method: 'GET' })
  }

  post<T = any>(config: AxiosRequestConfig): Promise<T> {
    return this.request({ ...config, method: 'POST' })
  }

  patch<T = any>(config: AxiosRequestConfig): Promise<T> {
    return this.request({ ...config, method: 'PATCH' })
  }

  delete<T = any>(config: AxiosRequestConfig): Promise<T> {
    return this.request({ ...config, method: 'DELETE' })
  }
}

export default HYRequest

2.6. VSCode配置

{
  "workbench.iconTheme": "vscode-great-icons",
  "editor.fontSize": 17,
  "eslint.migration.2_x": "off",
  "[javascript]": {
    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
  },
  "files.autoSave": "afterDelay",
  "editor.tabSize": 2,
  "terminal.integrated.fontSize": 16,
  "editor.renderWhitespace": "all",
  "editor.quickSuggestions": {
    "strings": true
  },
  "debug.console.fontSize": 15,
  "window.zoomLevel": 1,
  "emmet.includeLanguages": {
    "javascript": "javascriptreact"
  },
  "explorer.confirmDragAndDrop": false,
  "workbench.tree.indent": 16,
  "javascript.updateImportsOnFileMove.enabled": "always",
  "editor.wordWrap": "on",
  "path-intellisense.mappings": {
    "@": "${workspaceRoot}/src"
  },
  "hediet.vscode-drawio.local-storage": "eyIuZHJhd2lvLWNvbmZpZyI6IntcImxhbmd1YWdlXCI6XCJcIixcImN1c3RvbUZvbnRzXCI6W10sXCJsaWJyYXJpZXNcIjpcImdlbmVyYWw7YmFzaWM7YXJyb3dzMjtmbG93Y2hhcnQ7ZXI7c2l0ZW1hcDt1bWw7YnBtbjt3ZWJpY29uc1wiLFwiY3VzdG9tTGlicmFyaWVzXCI6W1wiTC5zY3JhdGNocGFkXCJdLFwicGx1Z2luc1wiOltdLFwicmVjZW50Q29sb3JzXCI6W1wiRkYwMDAwXCIsXCIwMENDNjZcIixcIm5vbmVcIixcIkNDRTVGRlwiLFwiNTI1MjUyXCIsXCJGRjMzMzNcIixcIjMzMzMzM1wiLFwiMzMwMDAwXCIsXCIwMENDQ0NcIixcIkZGNjZCM1wiLFwiRkZGRkZGMDBcIl0sXCJmb3JtYXRXaWR0aFwiOjI0MCxcImNyZWF0ZVRhcmdldFwiOmZhbHNlLFwicGFnZUZvcm1hdFwiOntcInhcIjowLFwieVwiOjAsXCJ3aWR0aFwiOjExNjksXCJoZWlnaHRcIjoxNjU0fSxcInNlYXJjaFwiOnRydWUsXCJzaG93U3RhcnRTY3JlZW5cIjp0cnVlLFwiZ3JpZENvbG9yXCI6XCIjZDBkMGQwXCIsXCJkYXJrR3JpZENvbG9yXCI6XCIjNmU2ZTZlXCIsXCJhdXRvc2F2ZVwiOnRydWUsXCJyZXNpemVJbWFnZXNcIjpudWxsLFwib3BlbkNvdW50ZXJcIjowLFwidmVyc2lvblwiOjE4LFwidW5pdFwiOjEsXCJpc1J1bGVyT25cIjpmYWxzZSxcInVpXCI6XCJcIn0ifQ==",
  "hediet.vscode-drawio.theme": "Kennedy",
  "editor.fontFamily": "Source Code Pro, 'Courier New', monospace",
  "editor.smoothScrolling": true,
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "workbench.colorTheme": "Atom One Dark",
  "vetur.completion.autoImport": false,
  "security.workspace.trust.untrustedFiles": "open",
  "eslint.lintTask.enable": true,
  "eslint.alwaysShowStatus": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  }
}