讓vue-cli3.0 配置簡單起來(vue.config.js編結)

前提：

隨着vue腳手架的升級，愈來愈便於開發者開發和維護項目，本質上vue-cli3提供了基礎的配置和可拓展的空間，可是vue-cli3官網對於新腳手架的用例都比較簡潔，更多的內容須要咱們去研究，更多都是基於webpack去拓展。爲了更好的入門，我寫了個經常使用配置的小總結，下面咱們來看看新的腳手架是如何快速上手的吧！

1.先安裝vue-cli3.0(按官方文檔走一邊):cli.vuejs.org/zh/guide/in…

2.建立項目：

a.手動建立:vue create my-project

cli.vuejs.org/zh/guide/cr…

手動建立，更具需求添加你須要的選項

b.經過 vue ui 命令以圖形化界面建立和管理項目（推薦）

1).選擇項目目錄，填寫項目所在文件夾名稱，包管理器有npm、yarn。

2).默認狀況下不少細節沒法知曉，故，初次使用建議選擇手動配置項目

3).在功能這塊，選你可能須要的便可，後面也能夠刪除或添加

4).路由模式、css預設處理器、編碼格式規則、測試等等設置(後期均可以改)。

5).設置項目名稱，若有須要能夠保持該項目的全部預設配置，方便下次建立同類型項目能夠直接選擇相同配置

3.建立成功接下來就要配置咱們的vue.config.js(配置以下)：

/**
 * *@2018-10-08
 * *@author trsoliu 
 * *@describe vue-cli 3.x配置文件
 */
const path = require('path');
const vConsolePlugin = require('vconsole-webpack-plugin'); // 引入 移動端模擬開發者工具 插件 （另：https://github.com/liriliri/eruda）
const CompressionPlugin = require('compression-webpack-plugin'); //Gzip
const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin; //Webpack包文件分析器
const baseUrl = process.env.NODE_ENV === "production" ? "/static/" : "/"; //font scss資源路徑 不一樣環境切換控制

module.exports = {
	//基本路徑
	//baseUrl: './',//vue-cli3.3如下版本使用
        publicPath:'./',//vue-cli3.3+新版本使用
	//輸出文件目錄
	outputDir: 'mcdonalds',
	// eslint-loader 是否在保存的時候檢查
	lintOnSave: true,
	//放置生成的靜態資源 (js、css、img、fonts) 的 (相對於 outputDir 的) 目錄。
	assetsDir: 'static',
	//以多頁模式構建應用程序。
	pages: undefined,
	//是否使用包含運行時編譯器的 Vue 構建版本
	runtimeCompiler: false,
	//是否爲 Babel 或 TypeScript 使用 thread-loader。該選項在系統的 CPU 有多於一個內核時自動啓用，僅做用於生產構建，在適當的時候開啓幾個子進程去併發的執行壓縮
	parallel: require('os').cpus().length > 1,
	//生產環境是否生成 sourceMap 文件，通常狀況不建議打開
	productionSourceMap: false,
	// webpack配置
	//對內部的 webpack 配置進行更細粒度的修改 https://github.com/neutrinojs/webpack-chain see https://github.com/vuejs/vue-cli/blob/dev/docs/webpack.md
	chainWebpack: config => {
		/**
		 * 刪除懶加載模塊的prefetch，下降帶寬壓力
		 * https://cli.vuejs.org/zh/guide/html-and-static-assets.html#prefetch
		 * 並且預渲染時生成的prefetch標籤是modern版本的，低版本瀏覽器是不須要的
		 */
		//config.plugins.delete('prefetch');
		//if(process.env.NODE_ENV === 'production') { // 爲生產環境修改配置...process.env.NODE_ENV !== 'development'
		//} else {// 爲開發環境修改配置...
		//}
	},
	//調整 webpack 配置 https://cli.vuejs.org/zh/guide/webpack.html#%E7%AE%80%E5%8D%95%E7%9A%84%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F
	configureWebpack: config => {
		//生產and測試環境
		let pluginsPro = [
			new CompressionPlugin({ //文件開啓Gzip，也能夠經過服務端(如：nginx)(https://github.com/webpack-contrib/compression-webpack-plugin)
				filename: '[path].gz[query]',
				algorithm: 'gzip',
				test: new RegExp('\\.(' + ['js', 'css'].join('|') + ')$', ),
				threshold: 8192,
				minRatio: 0.8,
			}),
			//	Webpack包文件分析器(https://github.com/webpack-contrib/webpack-bundle-analyzer)
			new BundleAnalyzerPlugin(),
		];
		//開發環境
		let pluginsDev = [
			//移動端模擬開發者工具(https://github.com/diamont1001/vconsole-webpack-plugin  https://github.com/Tencent/vConsole)
			new vConsolePlugin({
				filter: [], // 須要過濾的入口文件
				enable: true // 發佈代碼前記得改回 false
			}),
		];
		if(process.env.NODE_ENV === 'production') { // 爲生產環境修改配置...process.env.NODE_ENV !== 'development'
			config.plugins = [...config.plugins, ...pluginsPro];
		} else {
			// 爲開發環境修改配置...
			config.plugins = [...config.plugins, ...pluginsDev];
		}
	},
	css: {
		// 啓用 CSS modules
		modules: false,
		// 是否使用css分離插件
		extract: true,
		// 開啓 CSS source maps，通常不建議開啓
		sourceMap: false,
		// css預設器配置項
		loaderOptions: {
			sass: {
				//設置css中引用文件的路徑，引入通用使用的scss文件（如包含的@mixin）
				data: `
				$baseUrl: "/";
				@import '@/assets/scss/_common.scss';
				`
                                //data: `
                                //$baseUrl: "/";
                                //`
			}
		}
	},
	// webpack-dev-server 相關配置 https://webpack.js.org/configuration/dev-server/
	devServer: {
		// host: 'localhost',
		host: "0.0.0.0",
		port: 8000, // 端口號
		https: false, // https:{type:Boolean}
		open: true, //配置自動啓動瀏覽器  http://172.11.11.22:8888/rest/XX/ 
		hotOnly: true, // 熱更新
		// proxy: 'http://localhost:8000'   // 配置跨域處理,只有一個代理
		proxy: { //配置自動啓動瀏覽器
			"/XX/*": {
				target: "http://172.11.11.11:7071",
				changeOrigin: true,
				// ws: true,//websocket支持
				secure: false
			},
			"/XX2/*": {
				target: "http://172.12.12.12:2018",
				changeOrigin: true,
				//ws: true,//websocket支持
				secure: false
			},
		}
	},

	// 第三方插件配置 https://www.npmjs.com/package/vue-cli-plugin-style-resources-loader
	pluginOptions: {
		'style-resources-loader': {//https://github.com/yenshih/style-resources-loader
			preProcessor: 'scss',//聲明類型
			'patterns': [
                                //path.resolve(__dirname, './src/assets/scss/_common.scss'), 
			],
                        //injector: 'append'
		}
	}
};複製代碼

4.同時爲了保證ES版本的兼容，咱們還須要配置一下babel.config.js

//babel.config.js
module.exports = {
  presets: [
    [
      "@vue/app",
      {
        polyfills: ["es6.promise", "es6.symbol"]
      }
    ]
  ]
};
複製代碼

5.瀏覽器css兼容處理文件.browserslistrc以及.postcssrc.js

//.browserslistrc
> 1%
last 2 versions
not ie <= 8
複製代碼

//.postcssrc.js
module.exports = {
  plugins: {
    autoprefixer: {},
    //'postcss-px2rem': {
    //  remUnit: 75,
    //},
    'postcss-px2rem-exclude': {
      remUnit: 75,
      exclude: /node_modules|assets|login|main/gi,
    },
  }
};複製代碼

6..eslintrc.js的配置能夠直接在圖形化界面配置

module.exports = {
  root: true,
  env: {
    node: true
  },
  extends: ["plugin:vue/essential", "@vue/prettier"],
  rules: {
    "no-console": process.env.NODE_ENV === "production" ? "error" : "off",
    "no-debugger": process.env.NODE_ENV === "production" ? "error" : "off"
  },
  parserOptions: {
    parser: "babel-eslint"
  }
};複製代碼

這個配置我會更具項目持續更新，有建議或問題能夠加羣qq交流535798405

隨便再給個基於這個配置的一個demo：https://github.com/trsoliu/vue-cli3.x-configure