美文网首页
webpack基础使用

webpack基础使用

作者: zooeydotmango | 来源:发表于2019-10-12 03:34 被阅读0次

安装

npm init -y     //目录下产生package.json文件
npm install webpack webpack-cli --save-dev

常见的project下有src目录和dist目录,src表示源,常用来放编译前的原始代码,dist表示分布,放编译后的代码,用于生产站点。

起步

假如我们的project目录如下

  webpack-demo
  |- package.json
  |- /dist
     |- index.html
  |- /src
     |- index.js

在index.js中引用了某个包,此时执行npx webpack,会将我们的脚本 src/index.js 作为入口起点,也会生成 dist/main.js 作为输出。此时dist中的index.html只引入main.js就能正常使用。


创建一个配置文件webpack.config.js


const path = require('path');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: 'main.js',
    path: path.resolve(__dirname, 'dist')
  }};

再通过新的配置文件再次执行构建:
npx webpack --config webpack.config.js

如果 webpack.config.js 存在,则 webpack 命令将默认选择使用它。我们在这里使用 --config 选项只是向你表明,可以传递任何名称的配置文件。这对于需要拆分成多个文件的复杂配置是非常有用。


考虑到用CLI方式运行本地webpack副本不是特别方便,我们可以在package.json的script中添加命令来代替我们之前使用的npx命令


{
    "name": "webpack-demo",
    "version": "1.0.0",
    "description": "",
    "scripts": {
      "test": "echo \"Error: no test specified\" && exit 1",
+     "build": "webpack"            //npx webpack
    },
    "keywords": [],
    "author": "",
    "license": "ISC",
    "devDependencies": {
      "webpack": "^4.20.2",
      "webpack-cli": "^3.1.2"
    },
    "dependencies": {
      "lodash": "^4.17.5"
    }
  }

管理资源

webpack也可以管理其他资源例如css、images

加载CSS

为了在 JavaScript 模块中 import 一个 CSS 文件,你需要安装 style-loader 和 css-loader,并在 module 配置 中添加这些 loader:

npm install --save-dev style-loader css-loader

webpack.config.js

 const path = require('path');

  module.exports = {
    entry: './src/index.js',
    output: {
      filename: 'bundle.js',
      path: path.resolve(__dirname, 'dist')
    },
+   module: {
+     rules: [
+       {
+         test: /\.css$/,
+         use: [
+           'style-loader',
+           'css-loader'
+         ]
+       }
+     ]
+   }
  };

此时在src中添加css文件,并引入到index.js中,打包后css内容会出现在最终页面的head标签内。

现有的 loader 可以支持任何你可以想到的 CSS 风格 - postcss, sass 和 less 等

加载images

类似css,先安装,再配置module

npm install --save-dev file-loader

在配置文件的module下rules加

+       {
+         test: /\.(png|svg|jpg|gif)$/,
+         use: [
+           'file-loader'
+         ]
+       }

同理,src下添加图片,index.js中引用,css文件中使用,构建并打开最终文件,图片就正常显示了

加载 fonts 字体

file-loader 和 url-loader 可以接收并加载任何文件,然后将其输出到构建目录。这就是说,我们可以将它们用于任何类型的文件,也包括字体。因此我们只需更新配置文件:

+       {
+         test: /\.(woff|woff2|eot|ttf|otf)$/,
+         use: [
+           'file-loader'
+         ]
+       }
加载数据

加载的有用资源还有数据,如 JSON 文件,CSV、TSV 和 XML。类似于 NodeJS,JSON 支持实际上是内置的,也就是说 import Data from './data.json' 默认将正常运行。
要导入 CSV、TSV 和 XML,你可以使用 csv-loader 和 xml-loader

npm install --save-dev csv-loader xml-loader

配置:

+       {
+         test: /\.(csv|tsv)$/,
+         use: [
+           'csv-loader'
+         ]
+       },
+       {
+         test: /\.xml$/,
+         use: [
+           'xml-loader'
+         ]
+       }

管理输出

当我们需要分包,就需要输出不止一个js文件,因此修改配置文件:

 const path = require('path');

  module.exports = {
+   entry: {
+     app: './src/index.js',
+     print: './src/print.js'
+   },
    output: {
+     filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

这样打包后会产生print.bundle.jsapp.bundle.js两个文件,如果手动修改index.html中的引用,就是正常显示,也可以用htmlWebpackPlugin来帮助解决


具体方法:安装插件

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

修改配置文件

   const path = require('path');
+ const HtmlWebpackPlugin = require('html-webpack-plugin');

  module.exports = {
    entry: {
      app: './src/index.js',
      print: './src/print.js'
    },
+   plugins: [
+     new HtmlWebpackPlugin({
+       title: '管理输出'
+     })
+   ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

这样在编译之后插件会创建一个全新的index.html并替换我们的原有文件


清理/dist文件夹
推荐做法是每次编译前清理这个文件夹,这样只会生成用到的文件。可以用clean-webpack-plugin这个插件:

npm install --save-dev clean-webpack-plugin
  const path = require('path');
  const HtmlWebpackPlugin = require('html-webpack-plugin');
+ const CleanWebpackPlugin = require('clean-webpack-plugin');

  module.exports = {
    entry: {
      app: './src/index.js',
      print: './src/print.js'
    },
    plugins: [
+     new CleanWebpackPlugin(),
      new HtmlWebpackPlugin({
        title: '管理输出'
      })
    ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

你可能会很感兴趣,webpack 和 webpack 插件似乎“知道”应该哪些文件生成。答案是,webpack 通过 manifest,可以追踪所有模块到输出 bundle 之间的映射。

如果你想要知道如何以其他方式来控制 webpack 输出,了解 manifest 是个好的开始。

通过 WebpackManifestPlugin 插件,可以将 manifest 数据提取为一个容易使用的 json 文件。

开发/调试

source map定位

webpack打包源码后,我们有可能很难追踪到错误和警告在源码中的位置。

使用source map就可以准确定位了,它会将编译后的代码映射回原始代码。它有很多不同的选项可以使用,可以根据需要进行配置。

开发工具

我们在开发调试的过程中经常需要编译代码,每次手动输入npm run build太麻烦,webpack提供了几个选项,帮助我们在代码变化后自动编译:

  1. 观察模式watch

在package.json的script中加入"watch": "webpack --watch",即可在命令行中npm run watch观察代码,改动后需要手动刷新浏览器

  1. webpack-dev-server
npm install --save-dev webpack-dev-server

在webpack.config.js的module.exports中添加

devServer: {
     contentBase: './dist'
 }

以上配置告知webpack-dev-server,在localhost:8080下建立服务,将dist下的文件,作为可访问文件。

依然在scripts中添加命令"start": "webpack-dev-server --open",在命令行中运行 npm start,就会看到浏览器自动加载页面。如果现在修改和保存任意源文件,web 服务器就会自动重新加载编译后的代码

webpack-dev-server的其他设置可以在这里看到

  1. webpack-dev-middleware
    webpack-dev-middleware因为笔者没用过这个,就只放链接供大家参考=。=

参考

webpack教程

相关文章

  • webpack进阶——缓存与独立打包

    系列:webpack入门——了解及使用webpack基础——常用配置解析 先来看看最基础的webpack配置: 在...

  • webpack 基础使用

    module.exports = {mode:"development", //定义当前开发环境(默认 prod...

  • webpack基础使用

    上一篇《什么是构建?webpack打包思想》webpack是在node环境里跑的,所以先搭建构建环境。node的安...

  • webpack基础使用

    安装 常见的project下有src目录和dist目录,src表示源,常用来放编译前的原始代码,dist表示分布,...

  • Webpack基础使用

    一、 1.1初始化项目 npm init -y 1.2安装Webpack npm install webpack ...

  • Webpack 4 学习03(配置入口和出口的进阶使用)

    前提:知道webpack4的基础配置以及如何使用配置文件进行打包第一讲 Webpack 4 学习01(基础配置) ...

  • html-webpack-plugin插件使用

    本篇在webpack-dev-server的使用的基础上 html-webpack-plugin html-web...

  • webpack的基础使用

    如果是直接用vue-cli脚手架搭建的vue项目, webpack会先提前配置好 最原始的关于webpack使用的...

  • webpack-基础使用

    网页静态资源 1.在网页中会引用哪些常见的静态资源? JS .js .jsx .coffee .ts(Typ...

  • webpack的基础使用

    一、项目初始化及 webpack 安装 初始化完成之后项目会有一个 package.json 和一个 node_m...

网友评论

      本文标题:webpack基础使用

      本文链接:https://www.haomeiwen.com/subject/kpyfmctx.html