webpack的基本使用
一.安装webpack
(1) 打开项目目录终端,输入命令:
npm install webpack webpack-cli -D
(2) 然后在项目根目录中,创建一个 webpack.config.js 的配置文件用来配置webpack
在 webpack.config.js 文件中编写代码进行webpack配置,如下:
module.exports = {
mode:"development" //可以设置为development(开发模式),production(发布模式)
}
补充:mode设置的是项目的编译模式。
如果设置为development则表示项目处于开发阶段,不会进行压缩和混淆,打包速度会快一些
如果设置为production则表示项目处于上线发布阶段,会进行压缩和混淆,打包速度会慢一些
(3) 修改项目中的package.json文件添加运行脚本build,如下:
"scripts":{
"dev":"webpack"
}
注意:scripts节点下的脚本,可以通过 npm run 运行,如:
运行终端命令:npm run dev
将会启动webpack进行项目打包
(4) 运行build命令进行项目打包,并在页面中引入项目打包生成的js文件
打开项目目录终端,输入命令:
npm run dev
等待webpack打包完毕之后,找到默认的dist路径中生成的main.js文件,将其引入到html页面中。
浏览页面查看效果。
二.设置webpack的打包入口/出口
在webpack 4.x中,默认会将src/index.js 作为默认的打包入口js文件,默认会将dist/main.js 作为默认的打包输出js文件
如果不想使用默认的入口/出口js文件,我们可以通过改变 webpack.config.js 来设置入口/出口的js文件,如下:
const path = require("path"); // 引入node中的path模块处理绝对路径
module.exports = {
mode:"development",
//设置入口文件路径
entry: path.join(__dirname,"./src/xx.js"),
//设置出口文件
output:{
//设置路径
path:path.join(__dirname,"./dist"),
//设置文件名
filename:"res.js"
}
}
三.设置webpack的自动打包
默认情况下,我们更改入口js文件的代码,需要重新运行命令打包webpack,才能生成出口的js文件
那么每次都要重新执行命令打包,这是一个非常繁琐的事情,那么,自动打包可以解决这样繁琐的操作。
实现自动打包功能的步骤如下:
(1) 安装自动打包功能的包:webpack-dev-server
npm install webpack-dev-server -D
(2) 修改package.json中的dev指令如下:
"scripts":{
"dev":"webpack-dev-server"
}
(3) 将index.html引入的js文件路径更改为:
<script src="/bundle.js"></script>
// 使用网站根目录作为引入路径
(4) 运行npm run dev,进行打包
(5) 打开网址查看效果:http://localhost:8080
注意:webpack-dev-server自动打包的输出文件,默认放到了服务器的根目录中.
补充:
在自动打包完毕之后,默认打开服务器网页,实现方式就是打开package.json文件,修改dev命令:
“dev”: “webpack-dev-server --open --host 127.0.0.1 --port 9999”
四.配置生成一个预览页面html-webpack-plugin
使用html-webpack-plugin 可以生成一个预览页面。
因为当我们访问默认的 http://localhost:8080/的时候,看到的是一些文件和文件夹,想要查看我们的页面
还需要点击文件夹点击文件才能查看,那么我们希望默认就能看到一个页面,而不是看到文件夹或者目录。
实现默认预览页面功能的步骤如下:
(1) 安装默认预览功能的包:html-webpack-plugin
npm install html-webpack-plugin -D
(2) 修改webpack.config.js文件,如下:
const path = require("path"); // 引入node中的path模块处理绝对路径
//导入包
const HtmlWebpackPlugin = require("html-webpack-plugin");
//创建对象
const htmlPlugin = new HtmlWebpackPlugin({
//设置生成预览页面的模板文件,(需要展示的首页)
template:"./src/index.html",
//设置生成的预览页面名称
filename:"index.html"
})
module.exports = {
mode:"development",
//设置入口文件路径
entry: path.join(__dirname,"./src/xx.js"),
//设置出口文件
output:{
//设置路径
path:path.join(__dirname,"./dist"),
//设置文件名
filename:"res.js"
},
// 添加plugins信息
plugins:[ htmlPlugin ]
}
五.webpage打包非js模块
通过loader打包非js模块:默认情况下,webpack只能打包js文件,如果想要打包非js文件,需要调用loader加载器才能打包
loader加载器包含:
(1)less-loader
(2)sass-loader
(3)url-loader:打包处理css中与url路径有关的文件
(4)babel-loader:处理高级js语法的加载器
(5)postcss-loader
(6)css-loader,style-loader
注意:指定多个loader时的顺序是固定的,而调用loader的顺序是从后向前进行调用
1.安装style-loader,css-loader来处理样式文件
(1) 安装包
npm install style-loader css-loader -D
(2) 配置规则:更改webpack.config.js的module中的rules数组
const path = require("path"); // 引入node中的path模块处理绝对路径
//导入包
const HtmlWebpackPlugin = require("html-webpack-plugin");
//创建对象
const htmlPlugin = new HtmlWebpackPlugin({
//设置生成预览页面的模板文件,(需要展示的首页)
template:"./src/index.html",
//设置生成的预览页面名称
filename:"index.html"
})
module.exports = {
mode:"development",
//设置入口文件路径
entry: path.join(__dirname,"./src/xx.js"),
//设置出口文件
output:{
//设置路径
path:path.join(__dirname,"./dist"),
//设置文件名
filename:"res.js"
},
// 添加plugins信息
plugins:[ htmlPlugin ],
module : {
rules:[
{
//test设置需要匹配的文件类型,支持正则
test:/\.css$/,
//use表示该文件类型需要调用的loader
use:['style-loader','css-loader']
// 1.use数组中指定的loader顺序是固定的
// 先写style-loader,再写css-loader
// 2.多个loader的调用顺序是:从后往前调用,
// 先css-loader处理,再style-loader,前面没有了就交给webpack
}
]
}
}
2.安装less,less-loader处理less文件
(1) 安装包
npm install less-loader less -D
(2) 配置规则:更改webpack.config.js的module中的rules数组
module.exports = {
......
plugins:[ htmlPlugin ],
module : {
rules:[
{
//test设置需要匹配的文件类型,支持正则
test:/\.css$/,
//use表示该文件类型需要调用的loader
use:['style-loader','css-loader']
},
{
test:/\.less$/,
use:['style-loader','css-loader','less-loader']
}
]
}
}
3.安装sass-loader,node-sass处理less文件
(1).安装包
npm install sass-loader node-sass -D
(2) 配置规则:更改webpack.config.js的module中的rules数组
module.exports = {
......
plugins:[ htmlPlugin ],
module : {
rules:[
{
//test设置需要匹配的文件类型,支持正则
test:/\.css$/,
//use表示该文件类型需要调用的loader
use:['style-loader','css-loader']
},
{
test:/\.less$/,
use:['style-loader','css-loader','less-loader']
},
{
test:/\.scss$/,
use:['style-loader','css-loader','sass-loader']
}
]
}
}
补充:安装sass-loader失败时,大部分情况是因为网络原因,详情参考:
https://segmentfault.com/a/1190000010984731?utm_source=tag-newest.
4.安装post-css自动添加css的兼容性前缀(-ie-,-webkit-)
(1) 安装包
npm install postcss-loader autoprefixer -D
(2) 在项目根目录创建并配置 postcss.config.js 文件
const autoprefixer = require("autoprefixer"); // 导入自动添加前缀插件
module.exports = {
plugins:[ autoprefixer ] // 挂载插件
}
(3) 配置规则:更改webpack.config.js的module中rules数组中css的配置,在 ‘css-loader’ 后加上 ‘postcss-loader’
module.exports = {
......
plugins:[ htmlPlugin ],
module : {
rules:[
{
//test设置需要匹配的文件类型,支持正则
test:/\.css$/,
//use表示该文件类型需要调用的loader
use:['style-loader','css-loader','postcss-loader']
},
{
test:/\.less$/,
use:['style-loader','css-loader','less-loader']
},
{
test:/\.scss$/,
use:['style-loader','css-loader','sass-loader']
}
]
}
}
5.打包样式表中的图片以及字体文件
在样式表css中有时候会设置背景图片和设置字体文件,一样需要loader进行处理
使用url-loader和file-loader来处理打包图片文件以及字体文件
(1) 安装包
npm install url-loader file-loader -D
(2) 配置规则:更改webpack.config.js的module中的rules数组
module.exports = {
......
plugins:[ htmlPlugin ],
module : {
rules:[
{
//test设置需要匹配的文件类型,支持正则
test:/\.css$/,
//use表示该文件类型需要调用的loader
use:['style-loader','css-loader','postcss-loader']
},
{
test:/\.less$/,
use:['style-loader','css-loader','less-loader']
},
{
test:/\.scss$/,
use:['style-loader','css-loader','sass-loader']
},
{
test:/\.jpg|png|gif|bmp|ttf|eot|svg|woff|woff2$/,
//limit用来设置图片字节大小,只有小于limit值的图片,才会转换
//为base64图片
use:"url-loader?limit=16940"
}
]
}
}
6.打包js文件中的高级语法
编写js的时候,有时候我们会使用高版本的js语法
有可能这些高版本的语法不被兼容,我们需要将之打包为兼容性的js代码
我们需要安装babel系列的包
(1) 安装babel转换器
npm install babel-loader @babel/core @babel/runtime -D
(2) 安装babel语法插件包
npm install @babel/preset-env @babel/plugin-transform-runtime @babel/plugin-proposal-class-properties -D
(3) 在项目根目录创建并配置babel.config.js文件
module.exports = {
presets:["@babel/preset-env"],
plugins:[ "@babel/plugin-transform-runtime", "@babel/plugin-proposal-class-properties" ]
}
(4) 配置规则:更改webpack.config.js的module中的rules数组,
添加"babel-loader",) 一定添加 exclude:/node_modules/ 否则报错)
module.exports = {
......
plugins:[ htmlPlugin ],
module : {
rules:[
{
//test设置需要匹配的文件类型,支持正则
test:/\.css$/,
//use表示该文件类型需要调用的loader
use:['style-loader','css-loader','postcss-loader']
},
{
test:/\.less$/,
use:['style-loader','css-loader','less-loader']
},
{
test:/\.scss$/,
use:['style-loader','css-loader','sass-loader']
},
{
test:/\.jpg|png|gif|bmp|ttf|eot|svg|woff|woff2$/,
//limit用来设置图片字节大小,只有小于limit值的图片,才会转换
//为base64图片
use:'url-loader?limit=16940'
},
{
test:/\.js$/,
use:{
loader: 'babel-loader',
options: {
presets: ['@babel/preset-env']
}
},
//exclude为排除项,意思是不要处理node_modules中的js文件
exclude:/node_modules/
}
]
}
}
webpack 中 Vue 单文件组件加载器
配置.vue文件的加载器
1.安装vue组件的加载器
npm install vue-loader vue-template-compiler -D
2.配置规则:更改webpack.config.js的module中的rules数组
const VueLoaderPlugin = require("vue-loader/lib/plugin");
const vuePlugin = new VueLoaderPlugin();
module.exports = {
......
plugins:[ htmlPlugin, vuePlugin ],
module : {
rules:[
...//其他规则
{
test:/.vue$/,
loader:"vue-loader",}
]
}
}
在webpack中使用vue
上一步我们安装处理了vue单文件组件的加载器,想要让vue单文件组件能够使用,我们必须要安装vue
并使用vue来引用vue单文件组件。
1.安装Vue
npm install vue -S
2.在入口文件中引入vue:
import Vue from "vue"
import App from './components/App.vue'
3.创建Vue实例对象并指定el,最后使用render函数渲染单文件组件
const vm = new Vue({
el:"#app",
render:h=>h(App)
})
import Vue from "vue" // 2.在入口文件中引入vue
import App from './components/App.vue' // 引入APP单文件组件(或根组件)
// 3.new 一个 Vue 实例对象并指定 el 区域,最后使用render函数渲染单文件组件(或根组件)
const vm = new Vue({
el:"#app",
render:h=>h(App)
})
使用webpack打包发布项目
在项目上线之前,我们需要将整个项目打包并发布。
1.配置package.json
"scripts":{
"dev":"webpack-dev-server",
"build":"webpack -p"
}
2.在项目打包之前,可以将dist目录删除,生成全新的dist目录