从零开始搭建一个简单的基于webpack的vue开发环境
注：基于webpack3.X的版本，webpack4.X的版本不适用
参考链接：
https://segmentfault.com/a/1190000012789253?utm_source=tag-newest
我的github：
https://github.com/meilulan/webpack-vue-practice
[TOC]
总结
_summary.png
项目初始化
1. 安装node.js
2. 创建项目目录并npm初始化
1. 新建“webpack-vue-practice”文件夹
2. 初始化并获取package.json文件
cd webpack-vue-practice
npm init -y
“-y”表示将项目设置默认，以后可在package.json中更改
3. 引入webpack
1. 在项目中安装webpack、vue等相关插件
npm install --save-dev webpack@3 webpack-dev-server@2
npm i --save-dev vue
2. 在项目根目录下新建“index.html”文件
index.html
基于webpack3.X的vue开发环境
3. 在项目根目录下新建“webpack.config.js”配置文件
webpack.config.js
const path = require('path');
const webpack = require('webpack');
module.exports = {
}
4. 在项目根目录下新建“src"文件夹，并在/src下新建“main.js”入口文件
到目前为止，项目目录的整体结构如下：
webpack-vue-practice01.png
5. 在/src文件夹下新建测试js文件“util.js”
util.js
export default function say() {
console.log("hello webpack!!");
}
6. 在main.js文件中引入util.js文件
main.js
import say from './util';
say();
配置
1. 配置webpack.config.js文件
webpack.config.js
const path = require('path');
const webpack = require('webpack');
module.exports = {
entry: './src/main.js',//项目的入口文件
output: {
path: path.resolve(__dirname, './dist'),//项目的打包文件目录
publicPath: '/dist/',//通过devServer访问路径
filename: 'index.js'//打包后的文件名
},
devServer: {
historyApiFallback: true,//如果找不到界面就返回默认首页index.html
overlay: true//可以在浏览器打开的页面显示终端编译时产生的错误
}
}
2. 配置package.json文件中的"scripts"对象
package.json
"scripts": {
"dev": "webpack-dev-server --open --hot",
"build": "webpack --progress --hide-modules"
},
3. 修改index.html，引入打包后的文件
index.html
4. 运行项目
npm run dev
可以发现浏览器自动打开了一个窗口，在浏览器的控制台里输出"hello webpack"
并且可以发现，我们随意修改util.js的文件，浏览器会自动刷新
5. 打包项目
npm run build
可以发现，在项目中自动新建了“/dist/build.js”的路径和文件
引入vue
1. 在main.js文件中引入vue，并在入口文件index.html中调用vue
main.js
import Vue from 'vue';
const vue = new Vue({
el: "#app",
data: {
message:"hello webpack-vue"
}
});
index.html
{{message}}
2. 在webpack.config.js文件中的配置解析vue模块的引用
resolve: {//帮组webpack找到bundle中需要引入的模块代码，这些代码包含在每个require/import语句中
alias: {
'vue$': 'vue/dist/vue.esm.js'
}
}
webpack.config.js文件的整体配置如下：
const path = require('path');
const webpack = require('webpack');
module.exports = {
entry: './src/main.js',//项目的入口文件
output: {
path: path.resolve(__dirname, './dist'),//项目的打包文件目录
publicPath: '/dist/',//通过devServer访问路径
filename: 'build.js'//打包后的文件名
},
devServer: {
historyApiFallback: true,//如果找不到界面就返回默认首页index.html
overlay: true//可以在浏览器打开的页面显示终端编译时产生的错误
},
resolve: {//帮组webpack找到bundle中需要引入的模块代码，这些代码包含在每个require/import语句中
alias: {
'vue$': 'vue/dist/vue.esm.js'
}
}
}
引入scss和css
注：webpack默认只支持js的模块化，如需其他格式的文件当成模块引入，需要用到webpack的loader解析器
1. 在项目中安装css
终端
npm install --save-dev css-loader vue-style-loader
2. 在项目中安装scss
终端
npm install --save-dev node-sass sass-loader
3. 在webpack.config.js的modules中配置css和sass
module: {
rules: [
//css
{
test: /\.css$/,
use: [
"vue-style-loader",
"css-loader"
]
},
//scss为扩展名的sass
{
test: /\.scss$/,
use: [
"vue-style-loader",
"css-loader",
"sass-loader"
]
},
//sass为扩展名的sass
{
test: /\.sass$/,
use: [
"vue-style-loader",
"css-loader",
"sass-loader"
]
}
]
}
4. 我们做个测试
在src目录下，新建“assets”目录，并在其下新建common.scss文件，写入以下样式
common.scss
body {
color: rgb(0, 128, 0);
}
启动后，可以看到浏览器中的文字颜色已改变，说明scss文件已经起作用了
使用babel转码
有些浏览器不是很支持ES6的语法，我们可以使用babelES6转换为ES5语法。
1. 在项目中安装babel
npm install --save-dev babel-loader @babel/core @babel/preset-env
2. 在webpack.config.js的module中配置babel
module: {
rules: [
//babel
{
test: /\.js$/,
loader: 'babel-loader',
exclude: /node_modules/
}
]
}
exclude：是指不需要使用的文件或目录，相对应的是include（手动指定哪些文件或目录）
3. 在项目根目录下创建babel的配置文件.babelrc
.babelrc
{
"presets": [
[
"@babel/preset-env",
{
"modules": false,
"targets": {
"browsers": [
">0.25%",
"not op_mini all"
]
}
}
]
]
}
babel的配置具体见babel官网
4. 引入@babel/plugin-transform-runtime
因为babel-core只是对新引入的语法进行转换，比如箭头函数、块级作用域等
但对新引入的对象，例如Promise、Set等这些只能使用babel的插件：@babel/plugin-transform-runtime
在项目开发环境中引入@babel/plugin-transform-runtime，同时在生产环境引入@babel/runtime
npm install --save-dev @babel/plugin-transform-runtime
npm install --save @babel/runtime
在.babelrc配置文件中引入plugin
"plugins": [
[
"@babel/plugin-transform-runtime",
{
"absoluteRuntime": false,
"corejs": false,
"helpers": true,
"regenerator": true,
"useESModules": false
}
]
]
.babelrc文件内容整体如下：
{
"presets": [
[
"@babel/preset-env",
{
"modules": false,
"targets": {
// The % refers to the global coverage of users from browserslist
"browsers": [
">0.25%",
"not op_mini all"
]
}
}
]
],
"plugins": [
[
"@babel/plugin-transform-runtime",
{
"absoluteRuntime": false,
"corejs": false,
"helpers": true,
"regenerator": true,
"useESModules": false
}
]
]
}
具体操作和解释，请查看 npm 和 babel 官网
引入图片资源
1. 安装文件模块
npm install --save-dev file-loader
2. 在webpack.config.js的module中引入文件模块
module: {
rules: [
//图片
{
test: /\.(png|jpe?g|gif|svg)$/,
loader: 'file-loader',
options: {
name: '[name].[ext]?[hash]'
}
}
]
}
3. 测试
1. 在项目的src目录下，新建img目录，并引入图片example.png
webpack-vue-practice02.png
2. 在项目中引用图片
main.js
Vue.component('my-pic', {
template: '![]()
',
data() {
return {
url: require('./img/example.png')
}
}
});
index.html
{{message}}
运行项目就能看到该图片了。
引入vue的单文件组件
在前面，我们使用了Vue.component来定义全局的组件
但在实际项目中，更推荐使用单文件组件
1. 安装单文件组件相关的插件
npm install --save-dev vue-loader vue-template-compiler
2. 在webpack.config.js的module和plugins中引用
webpack.config.js
const vueLoaderPlugin = require('vue-loader/lib/plugin');
module:{
rules:[
//vue单文件组件
{
test:/\.vue$/,
loader:'vue-loader',
options:{
loaders:{
'scss':[
'vue-style-loader',
'css-loader',
'sass-loader'
],
'sass':[
'vue-style-loader',
'css-loader',
'sass-loader'
]
}
}
}
]
},
plugins:[
new vueLoaderPlugin(),
]
3. 在src目录下新建App.vue文件
App.vue
{{msg}}
4. 修改main.js文件
main.js
import Vue from 'vue';
import App from './App.vue'
import './assets/common.scss';
const vue = new Vue({
el: "#app",
components: { App },
template: '5. 修改index.html文件
index.html
基于webpack3.X的vue开发环境
运行项目，即可看到页面能正确显示。