Vue管理系統前端系列一vue-cli4.x 初始化專案

發表於2020-08-20


專案介紹

lion-ui 是一個基於 RBAC 的管理系統前端專案,採用 vueelement-ui 前端技術棧,實現了登入許可權驗證,根據許可權動態生成選單等功能。使用 vue-cli4.x 初始化專案。
開發時採用 fastmock 來進行模擬請求資料。

暫時前端專案只有master分支,資料都是mock的,有基本輪廓,可clone下來快速開發。根據需求調整。後端系統將搭配 netcore3.1 敬請期待

個人域名文件教程
文件教程

部落格園文件
文件教程

技術基礎

該系列文章涉及到以下幾個知識點,請先熟悉相關文件

開發環境

安裝工具

目前版本基於 webpack 4.0+vue-cli 4.x 版本構建,需要 Node.js 8.9 或更高版本(該專案使用的是 12.18.1),相關知識可以自行進官網進行了解. 若有多個 node 版本,可以使用 nvm來進行管理

安裝打包工具 webpack,-g 表示全域性安裝。

npm install webpack -g

安裝 vue 腳手架專案初始化工具 vue-cli,-g 表示全域性安裝。
如果你之前都是基於 vue-cli2.X,你需要先解除安裝它:

#若有,則先解除安裝vue-cli
npm uninstall -g vue-cli
#安裝cli4.x
npm i -g @vue/cli
#或者 vue -V  檢視版本是否為4.x
vue --version

Vue CLI >= 3 和舊版使用了相同的 vue 命令,所以 Vue CLI 2 (vue-cli) 被覆蓋了。如果你還是想繼續使用 2.x 搭建專案,你可以全域性安裝一個橋接工具:

npm install -g @vue/cli-init
# 然後你就可以繼續使用vue init了
npm init webpack my-project

有時候 npm 的下載速度比較感人,建議設定淘寶映象

npm config set registry=http://registry.npm.taobao.org -g
#配置後可通過下面方式來驗證是否成功 :
npm config get registry

快速原型開發

tips:適用於開發單頁面宣傳,庫,元件等使用。

使用 vue servevue build 命令對單個 *.vue 檔案進行快速原型開發,
前提是得安裝一個額外的全域性擴充套件: npm install -g @vue/cli-service-global

在一個空的資料夾中,新建一個 .vue檔案,執行下面命令就能看到效果

#啟動服務
vue serve test.vue
#打包出生產環境的包
vue build test.vue

建立專案

vue create lion-ui

點選回車後,就會有各種選項,需要進行選擇,步驟以及我的選項如下:

兩個選擇,通過上下鍵操作:

  • default (babel, eslint) 預設配置 提供 babel 和 eslint 支援
  • Manually select features 自己手動去選擇需要的配置

這裡選擇的是手動去配置的選項。然後需要哪個選項就在哪個選項上按 空格,就能選中/取消。

每一項的功能,做一下簡單闡述:

  • Babel 主要是對 es6 語法轉換成相容的 js (選上)
  • TypeScript 支援使用 TypeScript 語法來編寫程式碼
  • PWA PWA 支援
  • Router 支援 vue 路由配置外掛(一般都會選擇)
  • Vuex 支援 vue 程式狀態管理模式 (一般都會選擇)
  • CSS Pre-processors 支援 css 前處理器 (一般都會選擇)
  • Linter / Formatter 支援程式碼風格檢查和格式化 (選上)
  • Unit Testing 單元測試
  • E2E Testing E2E 測試

一般通用的選擇如下:

當選擇完成後,點選回車,會對每個配置進行個人需要的配置操作,
當前操作配置如下:

    1. 是否採用 history 模式,如果選擇 Y,需要後臺配置具體看 vueRouter 官網解釋,這裡我門選擇 n。
    1. 選擇一種 css 預處理,專案一般採用 scss,選擇第一個。
    1. 選擇格式化程式碼方式,一般選擇 ESlint + Prettier
    1. 程式碼規則檢測,一般會選擇儲存就檢測 Lint on save
    1. 配置 Babel,PostCSS,ESLint 放在哪兒,這裡選擇的是專門的位置。
    1. 是否記錄當前專案配置,以方便下次建立專案可直接使用當前配置。快速建立。

根據提示,執行指令 cd project 然後執行命令npm run serve 啟動專案。

釋出專案為 npm run build

配置相關說明

當需要自定義 webpack 相關配置的時候,需要在專案根目錄中建立vue.config.js檔案,它會被@vue/cli-server自動載入,
相關配置內容官網將的很詳細,可以點選檢視

目錄結構

整個專案的目錄結構:


├── public                     # 靜態資源
│   ├── favicon.ico            # favicon圖示
│   └── index.html             # html模板
├── src                        # 原始碼
│   ├── api                    # 所有請求
│   │    └── modules          # 請求介面的各個模組
│   ├── assets                 # 圖片、字型等靜態資源
│   │    ├──img                # 圖片靜態資源
│   │    └──styles             # 全域性樣式等靜態資源
│   ├── components             # 全域性公用元件
│   ├── layout                 # 頁面整體佈局盒子
│   ├── plugins                # 全域性外掛部分
│   ├── router                 # 路由
│   ├── store                  # 全域性store管理
│   │    └── modules          # 各個模組狀態管理
│   ├── utils                  # 全域性公用方法
│   ├── views                  # views所有頁面
│   ├── App.vue                # 入口頁面
│   ├── main.js                # 入口檔案 載入元件 初始化等
├── .borwserslistrc            # 瀏覽器相容相關
├── .env.xxx                   # 環境變數配置
├── .eslintrc.js               # eslint 配置項
├── .gitignore                 # git忽略檔案設定
├── .babel.config.js           # babel-loader 配置
├── package.json               # package.json
└── vue.config.js              # vue-cli 配置

原文地址:http://book.levy.net.cn/doc/frontend/uiframe/env.html

相關文章