目录

1、开发环境准备

1.1 安装nodejs

首先安装Nodejs，直接去nodejs官网下载https://nodejs.org/en/，默认会安装Npm，所以这里可以不用单独安装。

1.2 使用淘宝Npm镜像

由于国内网络原因，如果直接使用Npm安装依赖包会因为网络和墙的原因导致不成功，好在淘宝给我提供了可以使用的镜像，地址是：。

1.3 IDE准备

目前前端开发比较火的IDE是Jetbrain的WebStorm，到其官网下载：

2.搭建Webpack工程

2.1 新建工程

当开发环境准备好后，就可以打开WebStorm，新建一个空项目，如下图：

使用webstorm的好处很多，其中之一就是可以直接在IDE里面调出控制台，如下图：

在控制台输入“npm init”初始化这个工程，控制台会让你输入如下信息，这里可以默认都回车，最后按照提示输入"yes"则初始化完成。

这时在工程根目录下会生成package.json，打开文件能看到刚才在控制台输入的信息，如下：

package.json文件是Nodejs和Npm查找依赖的清单，更多的信息可以参考这篇文档:

2.2 安装Webpack

关于Webpack的概念和作用可以参考这篇博文:

使用webpack的目的是让代码更模块化，方便维护和管理，这和在Java中用maven来管理包很相似。

2.2.1 安装

首先，在控制台输入命令:npm install webpack,这个命令的作用是让npm安装webpack到node_modules(该目录会自动生成)下。

• 在产品环境中，以在命令后加上--save，比如:npm install webpack --save，这个意思是说把webpack安装到node_modules下，并且更新package.json文件的dependencies。
• 在开发环境中，我们使用：npm install webpack --save-dev，将webpack安装到Node_modules下，并且更新package.json的devDependencies。
  这里我们使用在开发环境中的命令。

更多的NPM命令可以参看官网：

2.2.2 配置

1.首先，我们再工程目录下新建src目录，并在src下新建hello.js文件，文件内写如下代码:

export default function () {    const hello = document.createElement("div");    hello.textContent = "Hello Webpack!"    return  hello;}

这是按照ES6的语法来实现。

关于ES6的更多内容可以参考这篇文档：。

export是定义对外暴露的接口，default是为export提供一个默认输出，这样可以在import的时候自定义变量名而不用在import的时候指定export中的变量名。所以这段代码意思是：默认输入一个匿名函数。

2.然后，在hello.js同级下创建main.js，然后输入如下内容:

import Hello from "./hello";document.getElementById("app").appendChild(Hello());

import是将刚才所写的hello.js文件当做一个模块导入进来，"Hello"变量就是为这个匿名函数定义变量名，from后面就是被引入的文件地址，如果是js文件默认不用写，该路径可以是相对路径或者绝对路径，然后用js去从dom获取app节点，并添加子级元素。

3.在工程根目录新建public文件夹，并新建一个Index.html文件，如下：

然后在Html文件中创建一个div，其id为app，并在body尾处引入script，如下图:

4.在工程目录下新建webpack.config.js文件，编辑webpack.config.js文件，编写如下代码：

module.exports = {    entry: __dirname + "/src/main.js",    output: {        path: __dirname + "/public",        filename: "bundle.js"    }}

__dirname是nodejs中的全局变量，指向当前执行脚本的目录。

module.exports是webpack的对象，其中entry是指定入口文件，这里指定main.js为入口文件。output下的path是输出目录，filename是输出文件名称。通过path和filename组合就可以将我们再代码中引入的模块完整的输出到制定的文件中。

5.在控制台执行webpack命令，就可以看到bundle.js文件已经输出到Public目录下了

这个时候通过浏览器打开Index.html可以看到效果:

3、进阶Webpack

上面我们已经可以用webpack来打包我们的模块，不过这只是刚入门，后面我们会不断的完善webpack.config.js这个文件。

从刚才的例子中，我们需要自己手动的在html页面里面引入bundle.js文件，那么有没有自动帮我们引入文件的功能呢？回答肯定是有的，这里就介绍下Html-webpack-plugin插件。

3.1 常用插件

3.1.1 Html-webpack-plugin插件

插件官方地址是:。

1.要使用html插件，首先需要在项目中引入该模块，在控制台执行命令:

npm install html-webpack-plugin --save-dev

2.编辑webpack.config.js文件，在其中加入以下代码:

var HtmlWebpackPlugin = require("html-webpack-plugin");module.exports = {    entry: __dirname + "/src/main.js",    output: {        path: __dirname + "/public",        filename: "bundle.js"    },    plugins: [        new HtmlWebpackPlugin()    ]}

可以看到，使用require引入html-webpack-plugin，然后在配置中的plugins数组中new一个插件对象。

3.这个时候我们把public目录删除，再在控制台执行webpack命令，会看到如下：

注意看红框部分，首先，title已经被修改了插件默认值；其次，id为app的div已经没有了。最后，可看到在body末尾插件帮我们把bundle.js插入。

template属性

看插件官网，插件有一个template属性，可以指定模板文件，插件能按照模板帮我们插入js或者css引用。

官网地址是:。

看官网描述，默认会有一个ejs的loader会解析模板，至于ejs是什么？ejs是一个模板语言，在nodejs开发中经常会用到，这里可以把ejs完全当做一个html格式来用。

所以，在src目录下，我们新建一个index.temp.ejs文件，并把public下的index.html的内容拷贝到该文件中，并修改至如下:

可以看到，title已经被我们修改回webpack example了，并且也添加了id为app的div，还删除了script，接着，删除Public下的文件。然后我们再控制台输入webpack，等webpack打包编译完成，这时public下生成了bundle.js和index.html文件，编辑index.html文件，可以看到如下信息：

在Body末尾，插件自动给我们把script加上了。

3.1.2 Extract-text-webpack插件

如果我们也想把css文件也自动插入，那么就会用到extract-text-webpack插件。

其官网地址是:。

官网的usage如下：

const ExtractTextPlugin = require("extract-text-webpack-plugin");module.exports = {  module: {    rules: [      {        test: /\.css$/,        use: ExtractTextPlugin.extract({          fallback: "style-loader",          use: "css-loader"        })      }    ]  },  plugins: [    new ExtractTextPlugin("styles.css"),  ]}

1.首先还是要先在控制台输入命令：

npm install extract-text-webpack-plugin --save-dev。

这里要注意：官网只提示安装extract插件，其实在编译的时候，还需要style-loader和css-loader，所以还要执行命令:

npm install style-loader --save-dev

npm install css-loader --save-dev

2.然后在webpack.config.js文件上面，require一下这个插件

3.按照官网的用法，编写module节点，最后如下所示:

var HtmlWebpackPlugin = require("html-webpack-plugin");var ExtractTextWebpackPlugin = require("extract-text-webpack-plugin");module.exports = {    entry: __dirname + "/src/main.js",    output: {        path: __dirname + "/public",        filename: "bundle.js"    },    module: {        rules: [{            test: /\.css$/,            use: ExtractTextWebpackPlugin.extract({                fallback: "style-loader",                use: "css-loader"            })        }]    },    plugins: [        new HtmlWebpackPlugin({            template: "./src/index.temp.ejs"        }),        new ExtractTextWebpackPlugin("styles.css")    ]}

注意：

• test是正则表达式，不是字符串!!!，没有引号
• 在webpack2中，module下的loaders改为rules,后者拥有更多的功能

4.接着，我们在src目录下新建一个index.css文件，并编辑编写如下样式:

.custom{    font-size: 18px;    color: bisque;    border: 1px moccasin solid;    padding: 5px;}

5.然后，编辑index.temp.ejs文件，在div标签加入class="custom"，如下图红框处:

6.编辑main.js文件，在其顶部Import刚才新建的index.css文件，如下图:

import Hello from "./hello";import IndexStyle from "./index.css";document.getElementById("app").appendChild(Hello());

7.最后，在控制台输入命令

webpack

编译完成后，可以看到public目录下生成了style.css文件，编辑index.html文件，可以看到在Head中引入了Style.css文件,如下图:

3.2 开发服务器 - Webpack-dev-server

在开发中，我们会不断的调试页面和参数，如果每次都是执行webpack命令未免太累了，所以这里介绍一个开发服务器webpack-dev-server，它提供一个易于部署的服务器环境，并且具有实时重载的功能。

更多的文档可以参考：。

要使用这个功能，首先还先执行npm的安装命令

npm install webpack-dev-server --save-dev,

执行完成后，编辑package.json文件，添加"start"代码如下：

"scripts": {  "test": "echo \"Error: no test specified\" && exit 1",  "start":"webpack-dev-server --progress"}

"--progress"参数可以查看当前执行进度，在控制台输入"npm start"控制台会打印日志信息，最后出现编译成功，代表服务启动完成，这时打开http://localhost:8080，可以看到index.html的内容，如下图：

这个时候，编辑hello.js，添加一些字符串如下：

export default function () {    const hello = document.createElement("div");    hello.textContent = "Hello Webpack!This is my example!"    return  hello;}

保存后，打开浏览器不用刷新，就可以看到我们新添加的"This is my example"。