webpack 的安装与使用

一、什么是 webpack ？

webpack 是一个流行的前端项目构建工具（打包工具）

二、 在项目中安装和配置 webpack

① 新建项目空白目录，并运行 npm init –y 命令，用于初始化包管理配置文件 package.json

② 运行 npm install webpack webpack-cli –D 命令，安装 webpack 相关的包

③ 在项目根目录中，创建名为 webpack.config.js 的 webpack 配置文件，配置以下内容：

module.exports = {
	// mode 用来指定构建模式，平时建议使用development模式，项目上线才使用production模式
	mode: 'development' 
}

④ 在 package.json 配置文件中的 scripts 节点下，新增 dev 脚本如下：

"scripts": {
	"dev": "webpack" 
}

⑤ 在终端中运行 npm run dev 命令，启动 webpack 进行项目打包

⑥ 在项目根目录中就会自动生成一个dist文件夹，我们只需要把里面的main.js引入到项目中即可

三、如何自定义打包的入口与出口

① webpack 默认规定：打包的入口文件为 src -> index.js 、打包的出口文件为 dist -> main.js

② 如果想要修改打包的入口与出口，可以在 webpack.config.js 中新增如下配置信息：

const path = require('path') // 导入 node.js 中专门操作路径的模块
module.exports = {
    entry: path.join(__dirname, './src/index.js'), // 打包入口文件的路径
    output: {
        path: path.join(__dirname, './dist'), // 输出文件的存放路径
        filename: 'bundle.js' // 输出文件的名称
    }
}

③ 重新在终端中运行 npm run dev 命令，dist文件夹下面就会多出bundle.js，这就是我们打包好的输出文件，我们在项目当中把引入的main.js替换掉即可

四、配置 webpack 自动打包功能

① 运行 npm install webpack-dev-server –D 命令，安装支持项目自动打包的工具

② 修改 package.json -> scripts 中的 dev 命令如下：

"scripts": {
    "dev": "webpack-dev-server" 
}

③ 将 src -> index.html 中，script 脚本的引用路径修改为 “/bundle.js”

④ 在 webpack.config.js 中新增如下配置信息：

const path = require('path')
module.exports = {
  //编译模式
  mode: 'development'  //  开发用 development  | 项目上线用 production
  ,
  //__dirname 代表当前文件所处的目录(绝对路径)
  entry: path.join(__dirname,'./src/index.js'), //入口文件
  output: {
    path: path.join(__dirname,'./dist'),//输出文件存放路径
    filename: 'bundle.js'//输出文件名称
  },
  devServer: {
    static: {                               
      directory: path.join(__dirname, './'),  
      watch: true
    }
 }
}

⑤ 运行 npm run dev 命令，重新进行打包

⑥ 在浏览器中访问 http://localhost:8080 地址，可以查看自动打包效果

五、配置 html-webpack-plugin 生成预览页面

① 运行 npm install html-webpack-plugin –D 命令，安装生成预览页面的插件

② 修改 webpack.config.js ，添加如下配置信息：

// 导入生成预览页面的插件，得到一个构造函数
const HtmlWebpackPlugin = require('html-webpack-plugin');
const htmlPlugin = new HtmlWebpackPlugin({ // 创建插件的实例对象
  template: './src/index.html', // 指定要用到的模板文件
  filename: 'index.html' // 指定生成的文件的名称，该文件存在于内存中，在目录中不显示
})

const path = require('path')
module.exports = {
  //编译模式
  mode: 'development' // development  开发用（提高开发速度） | production
  ,
  //__dirname 代表当前文件所处的目录
  entry: path.join(__dirname, './src/index.js'), //入口文件
  output: {
    path: path.join(__dirname, './dist'),//输出文件存放路径
    filename: 'bundle.js'//输出文件名称
  },
  devServer: {
    static: {
      directory: path.join(__dirname, './'),
      watch: true
    }
  },
  plugins: [htmlPlugin] // plugins 数组是 webpack 打包期间会用到的一些插件列表
}

③ 通过修改 package.json 中的以下配置运行npm run dev可以实现自动打开浏览器页面、配置 IP 地址、配置端口的功能

 // --open 打包完成后自动打开浏览器页面
 // --host 配置 IP 地址
 // --port 配置端口
 "scripts": {
 "dev": "webpack-dev-server --open --host 127.0.0.1 --port 8888"
 },