快捷導(dǎo)航

Vite配置路徑別名的簡(jiǎn)單實(shí)現(xiàn)方法

更新時(shí)間：2023年04月04日 09:51:40 作者：ぃ?Gavin

Vite項(xiàng)目中我們可以手動(dòng)將src路徑設(shè)置**@**路徑別名,可以省下很多引入路徑的冗余路徑,下面這篇文章主要給大家介紹了關(guān)于Vite配置路徑別名的簡(jiǎn)單實(shí)現(xiàn)方法,需要的朋友可以參考下

1. 項(xiàng)目說(shuō)明

主技術(shù)棧：

Vite + Vue3 + TypeScript

項(xiàng)目中版本情況：

"Vite": "3.0.0"
"Vue":	"3.2.37"
"Ts":	"4.6.4"

出現(xiàn)問(wèn)題：

在配置完Vite后，正常開(kāi)發(fā)沒(méi)問(wèn)題，但是Ts類(lèi)型檢查報(bào)錯(cuò)：

找不到模塊"/xxx/xxx/xxx"或其相應(yīng)的類(lèi)型聲明

2. 解決方法

首先要配置Vite，根據(jù)官方文檔中的給出的類(lèi)型說(shuō)明：

Record<string, string> | Array<{ find: string | RegExp, replacement: string }>

由此可知：我們可以配置alias為一個(gè)對(duì)象，或一個(gè) { find, replacement } 的數(shù)組

具體配置：

在根目錄中的 vite.config.ts 中加入如下配置：（以下是我個(gè)人項(xiàng)目配置）

import { resolve } from "path"; // 導(dǎo)入 path 模塊，幫助我們解析路徑

export default defineConfig({
  resolve: { // 這里配置需要注意：Vite新版本resolve配置改為對(duì)象形式，如下：
    alias: [
      {
        find: '@',
        replacement: resolve(__dirname, "src"),
      },
      {
        find: 'comps',
        replacement: resolve(__dirname, "src/components"),
      },
      {
        find: 'apis',
        replacement: resolve(__dirname, "src/apis"),
      },
      {
        find: 'views',
        replacement: resolve(__dirname, "src/views"),
      },
      {
        find: 'routes',
        replacement: resolve(__dirname, "src/router"),
      },
      {
        find: 'store',
        replacement: resolve(__dirname, "src/store"),
      },
      {
        find: 'utils',
        replacement: resolve(__dirname, "src/utils"),
      },
      {
        find: 'styles',
        replacement: resolve(__dirname, "src/styles"),
      },
      {
        find: 'layout',
        replacement: resolve(__dirname, "src/Layout"),
      },
      {
        find: 'models',
        replacement: resolve(__dirname, "src/models"),
      },
      {
        find: 'hooks',
        replacement: resolve(__dirname, 'src/hooks')
      }
    ],
  }
})

這樣配置完成后，項(xiàng)目中可以正常使用，但是Ts類(lèi)型檢查會(huì)提示錯(cuò)誤，接著，配置根目錄下的 ts.config.json 文件：（這里還是我個(gè)人的配置，分別對(duì)應(yīng)Vite中配置好的別名）

注意：主要配置 baseUrl 和 paths 兩個(gè)配置項(xiàng)即可，其他選項(xiàng)是初始化項(xiàng)目自動(dòng)生成的

{
  "compilerOptions": {
    "target": "ESNext",
    "useDefineForClassFields": true,
    "module": "ESNext",
    "moduleResolution": "Node",
    "strict": true,
    "jsx": "preserve",
    "sourceMap": true,
    "resolveJsonModule": true,
    "isolatedModules": true,
    "esModuleInterop": true,
    "lib": ["ESNext", "DOM"],
    "skipLibCheck": true,
    "baseUrl": "./",
    "paths": {
      "@/*":["src/*"],
      "comps/*": ["src/components/*"],
      "apis/*": ["src/apis/*"],
      "views/*": ["src/views/*"],
      "routes/*": ["src/router/*"],
      "store/*": ["src/store/*"],
      "utils/*": ["src/utils/*"],
      "styles/*": ["src/styles/*"],
      "layout/*": ["src/Layout/*"],
      "models/*": ["src/models/*"],
      "hooks/*": ["src/hooks/*"]
    }
  },
  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"],
  "references": [{ "path": "./tsconfig.node.json" }]
}

配置完成后，Ts類(lèi)型檢查就不會(huì)報(bào)錯(cuò)了。（反應(yīng)慢的重啟一下VsCode）