由于react和vue官方提供的脚手架想要增加一些额外的需求改起来太麻烦了,于是我就自己搭了一个webpack的例子,这个例子主要实现了下面的功能(在文章最后也会附上我自己搭建的一个react的脚手架):
- 支持es6语法
- 支持css和less的编译
- 支持autoprefixer
- 支持开发时代码的热更新
- 支持代码的压缩打包
简单介绍一下webpack的几个概念
webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个 bundle。
-
入口(entry)
入口起点(entry point)指示 webpack 应该使用哪个模块,来作为构建其内部依赖图的开始。进入入口起点后,webpack 会找出有哪些模块和库是入口起点(直接和间接)依赖的
-
出口(output)
output 属性告诉 webpack 在哪里输出它所创建的 bundles,以及如何命名这些文件,默认值为 ./dist。基本上,整个应用程序结构,都会被编译到你指定的输出路径的文件夹中。你可以通过在配置中指定一个 output 字段,来配置这些处理过程。
-
loader
loader 让 webpack 能够去处理那些非 JavaScript 文件(webpack 自身只理解 JavaScript)。loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块,然后你就可以利用 webpack 的打包能力,对它们进行处理。
-
插件(plugins)
loader 被用于转换某些类型的模块,而插件则可以用于执行范围更广的任务。插件的范围包括,从打包优化和压缩,一直到重新定义环境中的变量。插件接口功能极其强大,可以用来处理各种各样的任务。
-
模式(mode)
通过选择 development 或 production 之中的一个,来设置 mode 参数,你可以启用相应模式下的 webpack 内置的优化
文件目录结构
首先我把代码的Git路径(见下)各位可以先clone下来体验一下,先npm install然后运行npm run dev就可以体验。
webpackdemo源码的下载和体验地址
这里讲解一下当前的文件夹目录结构
dist/ #build后的代码目录
src/ #源码的文件夹
index.html #html的模板文件
main.js #代码的入口文件
style.less #less的入口文件
style.css #css文件
postcss.config.js #postcss的配置文件(这里是配置autoprefixer)
webpack.common.js #用于存放和开发和发布都需要的webpack配置文件
webpack.dev.js #用于存放开发需要的webpack配置文件
webpack.prod.js #用于存放发布需要的webpack配置文件(压缩代码等)
通用的一些配置
入口和出口以及插件的一些解释
entry: [
'./src/main.js',// 编译js的入口文件
'./src/style.less' // 编译less的入口文件
],
output: { // 编译完成的js会放在dist文件夹下命名为bundle.js
filename: 'bundle.js',
path: path.resolve(__dirname, 'dist')
},
plugins: [
new CleanWebpackPlugin(['dist']), // 每次编译先删除旧的dist文件夹
new HtmlWebpackPlugin({
title: 'Production', // 用来生成页面的 title 元素
inject: true, // 注入所有的资源到特定的 template 或者 templateContent 中,如果设置为 true 或者 body,所有的 javascript 资源将被放置到 body 元素的底部,'head' 将放置到 head 元素中
template: './src/index.html', // 模板文件路径
})
],
开发和发布需要的一些单独的配置
开发过程主要是要便于调试,同时代码的热更新以及调试的方便
了解devServer更多参数(中文)
了解devServer更多参数(官网)
// 开发环境下的配置
module.exports = merge(common, {
devtool: 'inline-source-map', // 报错时方便调试
mode: 'development', // 设置当前模式为开发模式
devServer: { //
inline: true, // 在 dev-server 的两种不同模式之间切换。默认情况下,应用程序启用内联模式(inline mode)。这意味着一段处理实时重载的脚本被插入到你的包(bundle)中,并且构建消息将会出现在浏览器控制台
hot: true, // 启用 webpack 的模块热替换特性
openPage: '', // 当打开浏览器显示的页面
publicPath: '', // 此路径下的打包文件可在浏览器中访问
port: 3000, // 当前运行的端口
historyApiFallback: true, // 当使用 HTML5 History API 时,任意的 404 响应都可能需要被替代为 index.html
overlay: { // 展示编译的错误和警告
warnings: true,
errors:true
}
},
plugins: [
new webpack.NamedModulesPlugin(), // 当开启 HMR 的时候使用该插件会显示模块的相对路径
new webpack.HotModuleReplacementPlugin() // 当开启 HMR 的时候使用该插件会显示模块的相对路径
]
});
// 生产环境下的配置
module.exports = merge(common, {
devtool: 'source-map', // 整个 source map 作为一个单独的文件生成。它为 bundle 添加了一个引用注释,以便开发工具知道在哪里可以找到它
mode: 'production', // 设置当前模式为生产环境
plugins: [
new UglifyJSPlugin({ // 代码混淆
sourceMap: true,
uglifyOptions: {
warnings: false,
parse: {},
compress: {
warnings: false,
drop_debugger: true,
drop_console: true
},
}
})
]
});
其他插件的配置
这里主要是通过loader来实现的,loader功能非常强大。这里只介绍我在demo里使用到的一些loader。
官网常用的一些loader
- 支持es6的语法
使用的是babel-loader,具体代码见下:
// 安装babel-loade
npm install -D babel-loader @babel/core @babel/preset-env webpack
// 配置
module: {
rules: [
{
test: /\.m?js$/,
exclude: /(node_modules|bower_components)/,
use: {
loader: 'babel-loader',
options: {
presets: ['@babel/preset-env']
}
}
}
]
}
- css和less支持和autoprefixer
这里用到了style-loader、css-loader、postcss-loader、less-loader和autoprefixer。具体配置见代码(css其实也可以进行优化参考MiniCssExtractPlugin,有需要的同学可以参考文档优化):
//安装
npm install --save-dev style-loader css-loader postcss-loader less-loader autoprefixer
// 以下css的webpack配置,同时需要将编译的css引入到js才会进行编译
{
test: /\.css$/,
use: [
'style-loader',
'css-loader',
{
loader: 'postcss-loader',
options: {
plugins: [
autoprefixer({
browsers: ['last 3 versions', '> 1%']
})
]
}
}
]
},
// less的配置,同时要在webpack的entry配置less的入口文件
{
test: /\.less$/,
use: [{
loader: 'style-loader' // creates style nodes from JS strings
}, {
loader: 'css-loader' // translates CSS into CommonJS
}, {
loader: 'postcss-loader',
options: {
plugins: [
autoprefixer({
browsers: ['last 3 versions', '> 1%']
})
]
}
}, {
loader: 'less-loader' // compiles Less to CSS
}]
}
// autoprefixer需要新建postcss.config.js同时按下面配置
module.exports = {
plugins: [
require('autoprefixer')
]
}
自己封装的一个react脚手架
目前只封装了一个react的,vue的会在后面我会更新上来.
基于webpack的react脚手架
参考文档
- webpack官网
- webpack中文(中文版的仅供参考,以官网为主)
- webpack官网指南
- webpack官网api
- webpack官网loaders
- webpack官网插件
- autoprefixer
网友评论