vue CLI3.0使用及配置說明

本文從安裝到文件配置進行詳講忿峻,需要耐心操作和分析哦极舔。

(一)安裝:

1镊屎、下載安裝node: 登陸node官網(wǎng) 并選擇自己合適的node版本進行安裝;

2、安裝vue-cli腳手架工具

npm install -g @vue/cli
# OR
# 推薦使用
npm install -g yarn # 如果已有安裝气筋,此步驟不需要
yarn global add @vue/cli 

(二)創(chuàng)建一個項目:

vue create my-project
# OR
vue ui
  • 選擇合適的配置
# 版本信息
Vue CLI v3.7.0 
? Please pick a preset:
# 基礎配置
  vue-cli3-demo (vue-router, vuex, sass, babel, typescript, unit-mocha)
  default (babel, eslint)
# 自定義配置拆内,這里我們選擇自定義選項,點擊回車
> Manually select features
  • 選擇需要的插件及編譯工具
? Check the features needed for your project:
# 代碼轉換宠默,可以讓你更好的書寫前沿技術
 (*) Babel
# JavaScript 的一個超集麸恍,好東西用起來
 (*) TypeScript
# PWA支持,不要求使用可以不選
 ( ) Progressive Web App (PWA) Support
 (*) Router
 (*) Vuex
# css預編譯器
 (*) CSS Pre-processors
# 代碼格式化
 (*) Linter / Formatter
# 書寫單元測試用的,不要求使用可以不選
>(*) Unit Testing
 ( ) E2E Testing
  • 接下來的配置選項
# 是否使用class風格進行組件開發(fā)
? Use class-style component syntax? Yes
# 使用 babel 對 TypeScript 代碼進行編譯轉換
? Use Babel alongside TypeScript for auto-detected polyfills? Yes

? Use history mode for router? (Requires proper server setup for index fallback in production) Yes
# 選擇css預編譯搀矫,這里我們選擇Sass/SCSS
? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default): Sass/SCSS (with node-sass)
# 選擇代碼格式化配置
? Pick a linter / formatter config: Standard
# 代碼檢查方式
? Pick additional lint features: (Press <space> to select, <a> to toggle all, <i> to invert selection)Lint on save
# 選擇單元測試工具
? Pick a unit testing solution: Mocha
# 是否將配置放在單獨的文件中
? Where do you prefer placing config for Babel, PostCSS, ESLint, etc.? In dedicated config files
# 是否將此次配置保存
? Save this as a preset for future projects? No
  • 最后
cd my-project
npm run install
npm run serve
# OR 推薦使用
yarn install
yarn serve

(三)目錄結構

項目結構截圖

(四)環(huán)境變量配置

  • 環(huán)境變量說明
.env                # 在所有的環(huán)境中被載入
.env.local          # 在所有的環(huán)境中被載入抹沪,但會被 git 忽略
.env.[mode]         # 只在指定的模式中被載入
.env.[mode].local   # 只在指定的模式中被載入,但會被 git 忽略

1.新建環(huán)境變量 .env.development.test 用于測試環(huán)境 并添加如下代碼

NODE_ENV='development'
VUE_APP_URL='你的測試環(huán)境域名'

只有以 VUE_APP_ 開頭的變量會被 webpack.DefinePlugin 靜態(tài)嵌入到客戶端側的包中瓤球。你可以在應用的代碼中這樣訪問它們:
console.log(process.env.VUE_APP_URL)

2.修改 package.json,并在scripts里面添加如下代碼

"serve:test": "vue-cli-service serve --mode development.test",

3.如果項目中有使用到公共環(huán)境變量融欧,為了避免在每個.env文件中配置,我們也可以在vue.config.js里面進行配置

(五)添加配置文件 vue.config.js

vue.config.js 是一個可選的配置文件卦羡,如果項目的 (和 package.json 同級的) 根目錄中存在這個文件噪馏,那么它會被 @vue/cli-service 自動加載。你也可以使用 package.json 中的 vue 字段绿饵,但是注意這種寫法需要你嚴格遵照 JSON 的格式來寫欠肾。

// vue.config.js
module.exports = {
    // baseUrl從 Vue CLI 3.3 起已棄用,請使用publicPath拟赊。
    // baseUrl:'./', 
    // 配置sub-path后訪問路徑為https://xxx-path/sub-path/#/
    publicPath: process.env.NODE_ENV === 'production' ? '/sub-path/' : '/',
    // 輸出文件路徑董济,默認為dist
    outputDir: 'dist',  
    // 放置生成的靜態(tài)資源 (js、css要门、img虏肾、fonts) 的 (相對于 outputDir 的) 目錄。
    assetsDir: '', 
    // 指定生成的 index.html 的輸出路徑 (相對于 outputDir)欢搜。也可以是一個絕對路徑
    indexPath: '',
    // 配置多頁應用
    pages: {
        index: {
            // page 的入口
            entry: 'src/index/main.js',
            // 模板來源
            template: 'public/index.html',
            // 在 dist/index.html 的輸出
            filename: 'index.html',
            // 當使用 title 選項時封豪,
            // template 中的 title 標簽需要是 <title><%= htmlWebpackPlugin.options.title %></title>
            title: 'Index Page',
            // 在這個頁面中包含的塊枫匾,默認情況下會包含
            // 提取出來的通用 chunk 和 vendor chunk盐捷。
            chunks: ['chunk-vendors', 'chunk-common', 'index']
        },
        // 當使用只有入口的字符串格式時座韵,
        // 模板會被推導為 `public/subpage.html`
        // 并且如果找不到的話旷太,就回退到 `public/index.html`。
        // 輸出文件名會被推導為 `subpage.html`赊抖。
        subpage: 'src/subpage/main.js',
    },
    lintOnSave: true,  // 保存時 lint 代碼
    // css相關配置
    css: {
        // 是否使用css分離插件 ExtractTextPlugin
        extract: true,
        // 開啟 CSS source maps?
        sourceMap: false,
        // css預設器配置項
        loaderOptions: {
            // pass options to sass-loader
            sass: {
                // 自動注入全局變量樣式
                data: `
                    @import "src/你的全局scss文件路徑";
                `
            }
        },
        // 啟用 CSS modules for all css / pre-processor files.
        modules: false,
    },
    // 生產環(huán)境是否生成 sourceMap 文件
    productionSourceMap: false,
    //是否為 Babel 或 TypeScript 使用 thread-loader演闭。該選項在系統(tǒng)的 CPU 有多于一個內核時自動啟用肘迎,僅作用于生產構建廓推。
    parallel: require('os').cpus().length > 1,
    // 所有 webpack-dev-server 的選項都支持
    devServer: {
        port: 8080, // 配置端口
        open: true, // 自動開啟瀏覽器
        compress: true, // 開啟壓縮
        // 設置讓瀏覽器 overlay 同時顯示警告和錯誤
        overlay: {
            warnings: true,
            errors: true
        },
        // 設置請求代理
        proxy: {
            '/api': {
                target: '<url>',
                ws: true,
                changeOrigin: true
            },
            '/foo': {
                target: '<other_url>'
            }
        }
    },
}

(六)修改webpack配置信息

vue-cli3.0的版本已經將webpack的配置整合進vue.config.js里面了

// 安裝 babel-polyfill
// npm install babel-polyfill 或者 yarn add babel-polyfill
// 安裝 uglifyjs-webpack-plugin
// npm install uglifyjs-webpack-plugin -D 或者 yarn add uglifyjs-webpack-plugin -D

// vue.config.js
const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
const isProduction = process.env.NODE_ENV === 'production';

module.exports = {
    chainWebpack: config => {
        // 引入babel-polyfill
        config
            .entry('index')
            .add('babel-polyfill')
            .end();
        // 添加文件路徑別名
        config.resolve.alias.set("@", resolve("src"));
        if (isProduction) {
            // 生產環(huán)境注入cdn
            config.plugin('html')
                .tap(args => {
                    args[0].cdn = cdn;
                    return args;
                });
        }
    },
    configureWebpack: config => {
        if (isProduction) {
            // 為生產環(huán)境修改配置...
            config.plugins.push(
                //添加代碼壓縮工具刷袍,及設置生產環(huán)境自動刪除console
                new UglifyJsPlugin({
                    uglifyOptions: {
                        compress: {
                            warnings: false,
                            drop_debugger: true,
                            drop_console: true,
                        },
                    },
                    sourceMap: false,
                    parallel: true,
                })
            );
        } else {
            // 為開發(fā)環(huán)境修改配置...
        }
    },
}

3.分離第三方插件,引入cdn配置
這里介紹一個開源的cdn庫 www.bootcdn.cn/

// vue.config.js
const isProduction = process.env.NODE_ENV === 'production';
const cdn = {
    css: [],
    js: [
        'https://xxx-cdn-path/vue.runtime.min.js',
        'https://xxx-cdn-path/vue-router.min.js',
        'https://xxx-cdn-path/vuex.min.js',
        'https://xxx-cdn-path/axios.min.js',
    ]
}

module.exports = {
    configureWebpack: config => {
        if (isProduction) {
            // 用cdn方式引入,分離第三方插件
            config.externals = {
                'vue': 'Vue',
                'vuex': 'Vuex',
                'vue-router': 'VueRouter',
                'axios': 'axios'
            }
        } else {
            // 為開發(fā)環(huán)境修改配置...
        }
    },
}

修改html文件

<!DOCTYPE html>
<html lang="zh">

<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width,initial-scale=1.0">
  <link rel="icon" href="<%= BASE_URL %>static/favicon.ico" type="image/x-icon" />
  <link rel="shortcut icon" href="<%= BASE_URL %>static/favicon.ico" type="image/x-icon" />
  <title>my-project</title>
  <!-- 使用CDN的CSS文件 -->
  <% for (var i in htmlWebpackPlugin.options.cdn && htmlWebpackPlugin.options.cdn.css) { %>
    <link href="<%= htmlWebpackPlugin.options.cdn.css[i] %>" rel="preload" as="style">
    <link href="<%= htmlWebpackPlugin.options.cdn.css[i] %>" rel="stylesheet">
  <% } %>
  <!-- 使用CDN的JS文件 -->
  <% for (var i in htmlWebpackPlugin.options.cdn && htmlWebpackPlugin.options.cdn.js) { %>
    <link href="<%= htmlWebpackPlugin.options.cdn.js[i] %>" rel="preload" as="script">
  <% } %>
</head>

<body>
  <noscript>
    <strong>We're sorry but eye-admin doesn't work properly without JavaScript enabled. Please enable it to continue.</strong>
  </noscript>
  <div id="app"></div>
  <!-- built files will be auto injected -->
  <% for (var i in htmlWebpackPlugin.options.cdn && htmlWebpackPlugin.options.cdn.js) { %>
    <script src="<%= htmlWebpackPlugin.options.cdn.js[i] %>"></script>
  <% } %>
</body>

</html>

(七)關于打包后請求數(shù)的優(yōu)化點Preload and Prefetch

首先我們看一張圖



從圖中我們可以看出首次加載的資源非常多樊展,有217個請求呻纹,為什么會這樣呢堆生?

查看官方文檔,可以得知:

<link rel="preload"> 是一種 resource hint雷酪,用來指定頁面加載后很快會被用到的資源淑仆,所以在頁面加載的過程中,我們希望在瀏覽器開始主體渲染之前盡早 preload哥力。

默認情況下蔗怠,一個 Vue CLI 應用會為所有初始化渲染需要的文件自動生成 preload 提示。

這些提示會被 @vue/preload-webpack-plugin 注入吩跋,并且可以通過 chainWebpack 的 config.plugin('preload') 進行修改和刪除寞射。
<link rel="prefetch"> 是一種 resource hint,用來告訴瀏覽器在頁面加載完成后钞澳,利用空閑時間提前獲取用戶未來可能會訪問的內容。

默認情況下涨缚,一個 Vue CLI 應用會為所有作為 async chunk 生成的 JavaScript 文件 (通過動態(tài) import() 按需 code splitting 的產物) 自動生成 prefetch 提示轧粟。

這些提示會被 @vue/preload-webpack-plugin 注入,并且可以通過 chainWebpack 的 config.plugin('prefetch') 進行修改和刪除脓魏。

所以修改vue.config.js文件

// vue.config.js
module.exports = {
  chainWebpack: config => {
    // 移除 prefetch 插件
    config.plugins.delete('preload');
    config.plugins.delete('prefetch');
  }
}

(八)總結

vue-cli3在項目配置上精簡了很多兰吟,而且它也提供了很多配置選項,滿足定制化需要茂翔。各種配置也特別貼心混蔼,可以按照自己項目的需要進行自定義修改,大大減少了提升了開發(fā)的工作效率珊燎。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末惭嚣,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子悔政,更是在濱河造成了極大的恐慌晚吞,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,378評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件谋国,死亡現(xiàn)場離奇詭異槽地,居然都是意外死亡,警方通過查閱死者的電腦和手機芦瘾,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,356評論 2 382
  • 文/潘曉璐 我一進店門捌蚊,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人近弟,你說我怎么就攤上這事缅糟。” “怎么了祷愉?”我有些...
    開封第一講書人閱讀 152,702評論 0 342
  • 文/不壞的土叔 我叫張陵溺拱,是天一觀的道長逃贝。 經常有香客問我,道長迫摔,這世上最難降的妖魔是什么沐扳? 我笑而不...
    開封第一講書人閱讀 55,259評論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮句占,結果婚禮上沪摄,老公的妹妹穿的比我還像新娘。我一直安慰自己纱烘,他們只是感情好杨拐,可當我...
    茶點故事閱讀 64,263評論 5 371
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著擂啥,像睡著了一般哄陶。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上哺壶,一...
    開封第一講書人閱讀 49,036評論 1 285
  • 那天屋吨,我揣著相機與錄音,去河邊找鬼山宾。 笑死至扰,一個胖子當著我的面吹牛,可吹牛的內容都是我干的资锰。 我是一名探鬼主播敢课,決...
    沈念sama閱讀 38,349評論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼绷杜!你這毒婦竟也來了直秆?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 36,979評論 0 259
  • 序言:老撾萬榮一對情侶失蹤鞭盟,失蹤者是張志新(化名)和其女友劉穎切厘,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體懊缺,經...
    沈念sama閱讀 43,469評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡疫稿,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 35,938評論 2 323
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了鹃两。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片遗座。...
    茶點故事閱讀 38,059評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖俊扳,靈堂內的尸體忽然破棺而出途蒋,到底是詐尸還是另有隱情,我是刑警寧澤馋记,帶...
    沈念sama閱讀 33,703評論 4 323
  • 正文 年R本政府宣布号坡,位于F島的核電站懊烤,受9級特大地震影響,放射性物質發(fā)生泄漏宽堆。R本人自食惡果不足惜腌紧,卻給世界環(huán)境...
    茶點故事閱讀 39,257評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望畜隶。 院中可真熱鬧壁肋,春花似錦、人聲如沸籽慢。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,262評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽箱亿。三九已至跛锌,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間届惋,已是汗流浹背髓帽。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評論 1 262
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留盼樟,地道東北人氢卡。 一個月前我還...
    沈念sama閱讀 45,501評論 2 354
  • 正文 我出身青樓锈至,卻偏偏與公主長得像晨缴,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子峡捡,可洞房花燭夜當晚...
    茶點故事閱讀 42,792評論 2 345

推薦閱讀更多精彩內容