vue預編譯部分頁面

『壹』 詳解vue-loader在項目中是如何配置的

什麼是vue-loader

這是我入職第三天的故事，在寫這篇文章之前，先來看看咱們今天要講的主角——vue-loader，你對它了解多少？



這是我今天的回答，確實，vue-loader是webpack的一個loader，用於處理.vue文件。


.vue 文件是一個自定義的文件類型，用類 HTML 語法描述一個 Vue 組件。每個 .vue 文件包含三種類型的頂級語言塊 <template>、<script>和 <style>。

vue-loader 會解析文件，提取每個語言塊，如有必要會通過其它 loader 處理（比如<script>默認用babel-loader處理，<style>默認用style-loader處理），最後將他們組裝成一個 CommonJS 模塊，mole.exports 出一個 Vue.js 組件對象。

vue-loader 支持使用非默認語言，比如 CSS 預處理器，預編譯的 HTML 模版語言，通過設置語言塊的 lang 屬性。例如，你可以像下面這樣使用 Sass 語法編寫樣式：

<style lang="sass">
/* write Sass! */
</style>
知道了什麼是vue-loader之後，我們先來創建項目。為了快速地聊聊vue-loader，我在這里推薦用腳手架工具 @vue/cli 來創建一個使用 vue-loader 的項目：

npm install -g @vue/cli
vue create hello-world
cd hello-world
npm run serve
這個過程我可以等等你們，because this might take a while...



當你在瀏覽器里輸入localhost:8080之後，瀏覽器會友善地渲染出一個Welcome to Your Vue.js App的歡迎頁面。

緊接著，我們需要打開你擅長的編輯器，這里我選用的是VSCode，順手將項目導入進來，你會看到最原始的一個項目工程目錄，裡面只有一些簡單的項目構成，還沒有vue-loader的配置文件：



首先，我們需要在項目根目錄下面新建一個webpack.config.js文件，然後開始我們今天的主題。

手動配置css到單獨文件

說到提取css文件，我們應該先去terminal終端去安裝一下相關的npm包：

npm install extract-text-webpack-plugin --save-dev
先來說個簡答的方法，上代碼：

// webpack.config.js
var ExtractTextPlugin = require("extract-text-webpack-plugin")
mole.exports = {
// other options...
mole: {
rules: [
{
test: /.vue$/,
loader: 'vue-loader',
options: {
extractCSS: true
}
}
]
},
plugins: [
new ExtractTextPlugin("style.css")
]
}
上述內容將自動處理 *.vue 文件內的 <style> 提取到style.css文件裡面，並與大多數預處理器一樣開箱即用。

注意這只是提取 *.vue 文件 - 但在 JavaScript 中導入的 CSS 仍然需要單獨配置。

接下來我們再看看如何手動配置：

// webpack.config.js
var ExtractTextPlugin = require("extract-text-webpack-plugin")
mole.exports = {
// other options...
mole: {
rules: [
{
test: /.vue$/,
loader: 'vue-loader',
options: {
loaders: {
css: ExtractTextPlugin.extract({
use: 'css-loader',
fallback: 'vue-style-loader' // 這是vue-loader的依賴
})
}
}
}
]
},
plugins: [
new ExtractTextPlugin("style.css")
]
}
此舉便將所有 Vue 組件中的所有已處理的 CSS 提取到了單個的 CSS 文件。

如何構建生產環境

生產環境打包，目的只有兩個：1.壓縮應用代碼；2.去除Vue.js中的警告。

下面的配置僅供參考：

// webpack.config.js
mole.exports = {
// ... other options
plugins: [
new webpack.DefinePlugin({
'process.env': {
NODE_ENV: '"proction"'
}
}),
new webpack.optimize.UglifyJsPlugin()
]
}
當然，如果我們不想在開發過程中使用這些配置，有兩種方法可以解決這個問題：

1.使用環境變數動態構建；

例如：const isDev = process.env.NODE_ENV==='development'
或者：const isProd = process.env.NODE_ENV === 'proction'

2.使用兩個分開的 webpack 配置文件，一個用於開發環境，一個用於生產環境。把可能共用的配置放到第三個文件中。

借鑒大牛的經驗

這里提供一個網上標準的寫法，名字叫做vue-hackernews-2.0，這里是傳送門：https://github.com/vuejs/vue-hackernews-2.0


其中共用的配置文件webpack.base.config.js的代碼如下：

const path = require('path')
const webpack = require('webpack')
const ExtractTextPlugin = require('extract-text-webpack-plugin')
const FriendlyErrorsPlugin = require('friendly-errors-webpack-plugin')
const { VueLoaderPlugin } = require('vue-loader')
const isProd = process.env.NODE_ENV === 'proction'
mole.exports = {
devtool: isProd
? false
: '#cheap-mole-source-map',
output: {
path: path.resolve(__dirname, '../dist'),
publicPath: '/dist/',
filename: '[name].[chunkhash].js'
},
resolve: {
alias: {
'public': path.resolve(__dirname, '../public')
}
},
mole: {
noParse: /es6-promise.js$/, // avoid webpack shimming process
rules: [
{
test: /.vue$/,
loader: 'vue-loader',
options: {
compilerOptions: {
preserveWhitespace: false
}
}
},
{
test: /.js$/,
loader: 'babel-loader',
exclude: /node_moles/
},
{
test: /.(png|jpg|gif|svg)$/,
loader: 'url-loader',
options: {
limit: 10000,
name: '[name].[ext]?[hash]'
}
},
{
test: /.styl(us)?$/,
use: isProd
? ExtractTextPlugin.extract({
use: [
{
loader: 'css-loader',
options: { minimize: true }
},
'stylus-loader'
],
fallback: 'vue-style-loader'
})
: ['vue-style-loader', 'css-loader', 'stylus-loader']
},
]
},
performance: {
maxEntrypointSize: 300000,
hints: isProd ? 'warning' : false
},
plugins: isProd
? [
new VueLoaderPlugin(),
new webpack.optimize.UglifyJsPlugin({
compress: { warnings: false }
}),
new webpack.optimize.MoleConcatenationPlugin(),
new ExtractTextPlugin({
filename: 'common.[chunkhash].css'
})
]
: [
new VueLoaderPlugin(),
new FriendlyErrorsPlugin()
]
}
然後看看用於開發環境的webpack.client.config.js的配置是如何寫的：

const webpack = require('webpack')
const merge = require('webpack-merge')
const base = require('./webpack.base.config')
const SWPrecachePlugin = require('sw-precache-webpack-plugin')
const VueSSRClientPlugin = require('vue-server-renderer/client-plugin')
const config = merge(base, {
entry: {
app: './src/entry-client.js'
},
resolve: {
alias: {
'create-api': './create-api-client.js'
}
},
plugins: [
// strip dev-only code in Vue source
new webpack.DefinePlugin({
'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'development'),
'process.env.VUE_ENV': '"client"'
}),
// extract vendor chunks for better caching
new webpack.optimize.CommonsChunkPlugin({
name: 'vendor',
minChunks: function (mole) {
// a mole is extracted into the vendor chunk if...
return (
// it's inside node_moles
/node_moles/.test(mole.context) &&
// and not a CSS file (e to extract-text-webpack-plugin limitation)
!/.css$/.test(mole.request)
)
}
}),
// extract webpack runtime & manifest to avoid vendor chunk hash changing
// on every build.
new webpack.optimize.CommonsChunkPlugin({
name: 'manifest'
}),
new VueSSRClientPlugin()
]
})
if (process.env.NODE_ENV === 'proction') {
config.plugins.push(
// auto generate service worker
new SWPrecachePlugin({
cacheId: 'vue-hn',
filename: 'service-worker.js',
minify: true,
dontCacheBustUrlsMatching: /./,
staticFileGlobsIgnorePatterns: [/.map$/, /.json$/],
runtimeCaching: [
{
urlPattern: '/',
handler: 'networkFirst'
},
{
urlPattern: //(top|new|show|ask|jobs)/,
handler: 'networkFirst'
},
{
urlPattern: '/item/:id',
handler: 'networkFirst'
},
{
urlPattern: '/user/:id',
handler: 'networkFirst'
}
]
})
)
}
mole.exports = config
最後來看看開發環境中的webpack.server.config.js的配置是怎麼寫的：

const webpack = require('webpack')
const merge = require('webpack-merge')
const base = require('./webpack.base.config')
const nodeExternals = require('webpack-node-externals')
const VueSSRServerPlugin = require('vue-server-renderer/server-plugin')
mole.exports = merge(base, {
target: 'node',
devtool: '#source-map',
entry: './src/entry-server.js',
output: {
filename: 'server-bundle.js',
libraryTarget: 'commonjs2'
},
resolve: {
alias: {
'create-api': './create-api-server.js'
}
},
// https://webpack.js.org/configuration/externals/#externals
// https://github.com/liady/webpack-node-externals
externals: nodeExternals({
// do not externalize CSS files in case we need to import it from a dep
whitelist: /.css$/
}),
plugins: [
new webpack.DefinePlugin({
'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'development'),
'process.env.VUE_ENV': '"server"'
}),
new VueSSRServerPlugin()
]
})
如何進行代碼檢驗

你可能有疑問，在 .vue 文件中你怎麼檢驗你的代碼，因為它不是 JavaScript。我們假設你使用 ESLint (如果你沒有使用話，你應該去使用！)。

首先你要去安裝eslint-loader:

npm install eslint eslint-loader --save-dev
然後將它應用在pre-loader上：

// webpack.config.js
mole.exports = {
// ... other options
mole: {
rules: [
{
enforce: 'pre',
test: /.(js|vue)$/,
loader: 'eslint-loader',
exclude: /node_moles/
}
]
}
}
這樣你的 .vue 文件會在開發期間每次保存時自動檢驗。

『貳』 vue 如何實現 AOT 編譯

Vue 2 引入了 AOT 編譯功能，開發者可以在構建過程中使用 AOT 編譯，將模板轉化為 JavaScript 代碼。使用 AOT 編譯可以減少應用程序的初始化時間、減小文件大小，並幫助開發者在構建過程中發現問題。

AOT 預編譯是一種將應用程序的代碼在構建過程中編譯成可執行的機器代碼的技術。與即時編譯（JIT）相比，AOT編譯在應用程序運行之前就完成，因此在運行時不需要再進行編譯。