1、webpack从0到1-开始
这系列文章就是手把手教你如何从零构建一个webpack项目。目的就是为了了解webpack打包怎么玩的,平常项目开发中所用如ES6语法、less、vue是如何被打包的,是一个比较基础的内容,我也是为了总结一下这方面的知识点,梳理一下个人的知识体系而写下这些文字。
工具及版本:vscode、webpack(v4.41.5)、node(v10.16.0)
git仓库:webpack-demo
1、什么是webpack?
“webpack is a module bundler.”—webpack官网上打开自我介绍就是这句话,它是一个模块打包器。
webpack是一个模块打包工具,可以打包js、图片资源啊等等,功能十分强大,但是在最开始的时候呢,webpack只是个js模块打包工具。现在就让我们回到webpack最初的模样,从怎么用它打包js文件开始。
2、初始化
即然从零开始,首先自然得从git仓库建立开始,怎么详细的从零建一个git仓库我有写过了(->传送门),这个系列文章代码所对应的git仓库:webpack-demo。
进入到webpack-demo下的chapter1中,输npm init初始化生成一个package.json文件。(这里一路回车下一步下一步就行,或者npm init -y直接生成一个默认的文件)
$ cd webpack-demo/chapter1
$ npm init -y
新建一个src文件夹并在其中新建一个index.js文件:
var div = document.createElement("div");
div.innerText = "hello world";
document.body.appendChild(div);
再新建一个html5标准格式的index.html文件:
webpack从0到1
这样我们基本的一个项目结构及内容就生成了,浏览器打开index.html文件也能显示出"hello world"。
webpack-demo/chapter1
|- package.json
+ |- index.html
+ |- /src
+ |- index.js
3、安装webpack
然后我们需要安装下webpack,可以全局安装也可以本地安装,我推荐本地安装,这样可以避免与他人合作开发时由于webpack版本号不一致而导致的打包问题。具体:官网webpack安装
如果你没能绿色上网安装很慢的话可以使用淘宝镜像处理一下。
# 本地
$ npm install webpack webpack-cli --save-dev
# 全局
$ npm install webpack --global
--save-dev和--save两个有啥子区别呢?
后缀那个--save-dev可以简写为-D,这个会自动把模块和版本号添加到package.json中的devDependencies部分。
还有一个后缀--save可以简写为-S,这个会自动把模块和版本号添加到dependencies部分。
在安装一个要打包到生产环境的安装包时,你应该使用npm install --save,如果你在安装一个用于开发环境的安装包(例如,linter, 测试库等),你应该使用npm install --save-dev。请在npm文档中查找更多信息。
—— 引用来自webpack官网教程的解释。
还有我网上搜的另一个解释我也觉得很直观啊:
--save-dev是你开发时候依赖的东西,--save是你发布之后还依赖的东西。
比如,你写ES6代码,如果你想编译成ES5发布那么babel就是devDependencies。如果你用了jQuery,由于发布之后还是依赖jQuery,所以是dependencies。
—— 引用segmentfaul提问
安装完了以后我么就可以看到package.json中多出的这几行东西。
{
...
+ "devDependencies": {
+ "webpack": "^4.41.5",
+ "webpack-cli": "^3.3.10"
+ }
...
}
4、打包js
(1)第一种方式--使用默认打包的模式
我们可以直接在命令行中输入:
$ npx webpack
执行npx webpack,会将我们的src/index.js作为入口文件,然后会新建一个dist文件夹和dist/main.js作为输出文件。
npx webpack简单一点来说就是会去找项目中本地的./node_modules/.bin/webpack,然后中执行它。
这时我们就可以看到项目结构下生成了一个dist文件夹和打包好的main.js文件了。
(2)第二种方式--使用配置文件打包
删掉dist目录,在当前目录下新建一个webpack.config.js配置文件。
webpack-demo/chapter1
|- package.json
|- index.html
|- /src
|- index.js
+ |- webpack.config.js
配置文件webpack.config.js中写:
// 引入node中的path模块
const path = require('path');
module.exports = {
// 定义入口文件,告诉webpack我要打包啥
entry: './src/index.js',
// 定义输出文件,告诉webpack打包好的文件叫啥,给我放到哪里
output: {
filename: 'main.js',
path: path.resolve(__dirname, 'dist'),
},
};
打包,使用webpack-cli提供的命令行(这就是我们为什么要安装webpack-cli的原因):
$ npx webpack --config webpack.config.js
(3)第三种方式--使用npm脚本
上面使用webpack-cli命令打包的方式不够简洁明了,一般我们会在package.json中的scripts中定义一条命令。
{
...
+ "scripts": {
+ "build": "webpack"
+ }
...
}
打包,这个大家应该就很熟悉了,执行这条命令跟上面使用一样的效果,它会自动的去找文件目录下的webpack.config.js文件然后执行它。
$ npm run build
同样,这时我们就可以看到项目结构下生成了一个dist文件夹和打包好的main.js文件了。
5、最后
这时src/index.js文件已经通过webpack打包后输出为dist/main.js了,这个时候我们还得引用它,所以复制一份index.html文件到dist文件夹下。
webpack-demo/chapter1
|- package.json
|- /dist
+ |- index.html
|- main.js
|- index.html
|- /src
|- index.js
将dist/index.html文件内容改为:
webpack从0到1
-
+
这时候我们在浏览器中打开dist/index.html同样也可以看到hello world在屏幕中显示出来了,我们就简单了完成了一个js文件打包的过程。
6、其他
参考链接
Webpack 4 和单页应用入门
git教学
webpack官网
发表评论 (审核通过后显示评论):