webpack 入门教程

一、安装

  在安装node的前提下使用npm安装:

  1、全局安装:

    npm install webpack -g 

  2、本地项目安装:

 进入项目目录

 npm init 生成 package.json文件

 npm install webpack --save-dev 写入 package.json 包

 安装完成后使用命令提示符执行webpack-v查看是否正确安装,出现相应版本号则已正确安装;

  3、如果需要使用 Webpack 开发工具,要单独安装:

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

二、使用

  1、首先创建一个静态页面 index.html 和一个 JS 入口文件 entry.js:

  

<!-- index.html -->
<html>
<head>
  <meta charset="utf-8">
</head>
<body>
  <script src="bundle.js"></script>
</body>
</html>

  

// entry.js
document.write('It works.')

 

  2、使用webpack编译entry.js,并打包到bundle.js

    webpack entry.js bundle.js

    用浏览器打开 index.html 将会看到 It works.

  3、新增一个模块 module.js 并修改入口 entry.js

  

// module.js
//定义模块
module.exports = 'It works from module.js.'
//entry.js
document.write("你好,世界");
//接收模块
document.write(require("./module.js"));

  重新打包 webpack entry.js bundle.js 后刷新页面看到变化 It works.It works from module.js.

  Webpack 会分析入口文件,解析包含依赖关系的各个文件。这些文件(模块)都打包到 bundle.js 。

  Webpack 会给每个模块分配一个唯一的 id 并通过这个 id 索引和访问模块。在页面启动时,会先执行 entry.js 中的代码,其它模块会在运行 require 的时候再执行。

二、配置

  每个项目下都必须有一个 webpack.config.js ,webpack.config.js 是 webpack 的构建配置文件,它的作用如同常规的 gulpfile.js/Gruntfile.js ,就是一个配置项,告诉 webpack 它需要做什么;

  在package.js文件下添加依赖项:

  

{
  "name": "webpack",
  "version": "1.0.0",
  "description": "",
  "main": "bundle.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "css-loader": "^0.21.0",
    "style-loader": "^0.13.0",
    "webpack": "^1.13.3"
  }
}

 运行 npm install

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

var webpack = require('webpack')

module.exports = {
  entry: './entry.js',
  output: {
    path: __dirname,
    filename: 'bundle.js'
  },
  module: {
    loaders: [
      {test: /\.css$/, loader: 'style!css'}
    ]
  }
}

同时简化 entry.js 中的 style.css 加载方式:

require('./style.css')

最后运行 webpack

 

webpack.config.js配置项:

1.entry

entry可以是个字符串或数组或者是对象。 
当entry是个字符串的时候,用来定义入口文件:

entry: './js/main.js'

当entry是个数组的时候,里面同样包含入口js文件,另外一个参数可以是用来配置webpack提供的一个静态资源服务器,webpack-dev-server。webpack-dev-server会监控项目中每一个文件的变化,实时的进行构建,并且自动刷新页面:

entry: [
     'webpack/hot/only-dev-server',
     './js/app.js'
]

当entry是个对象的时候,我们可以将不同的文件构建成不同的文件,按需使用,比如在我的hello页面中只要\引入hello.js即可:

entry: {
     hello: './js/hello.js',
     form: './js/form.js'
 }

2.output 
output参数是个对象,用于定义构建后的文件的输出。其中包含path和filename:

output: {
     path: './build',
     filename: 'bundle.js'
 }

当我们在entry中定义构建多个文件时,filename可以对应的更改为[name].js用于定义不同文件构建后的名字。

3.module 
关于模块的加载相关,我们就定义在module.loaders中。这里通过正则表达式去匹配不同后缀的文件名,然后给它们定义不同的加载器。比如说给less文件定义串联的三个加载器(!用来定义级联关系)多个loader之间用“!”连接起来:

module: {
    loaders: [
        { test: /\.js?$/, loaders: ['react-hot', 'babel'], exclude: /node_modules/ },
        { test: /\.js$/, exclude: /node_modules/, loader: 'babel-loader'},
        { test: /\.css$/, loader: "style!css" },
        { test: /\.less/, loader: 'style-loader!css-loader!less-loader'}
    ]
}

此外,还可以添加用来定义png、jpg这样的图片资源在小于10k时自动处理为base64图片的加载器:

{ test: /\.(png|jpg)$/,loader: 'url-loader?limit=10000'}

给css和less还有图片添加了loader之后,我们不仅可以像在node中那样require js文件了,我们还可以require css、less甚至图片文件:

require('./bootstrap.css');
 require('./myapp.less');
 var img = document.createElement('img');
 img.src = require('./glyph.png');

但是需要知道的是,这样require来的文件会内联到 js bundle中。如果我们需要把保留require的写法又想把css文件单独拿出来,可以使用下面提到的[extract-text-webpack-plugin]插件。 
在上面示例代码中配置的第一个loaders我们可以看到一个叫做React-hot的加载器。我的项目是用来学习react写相关代码的,所以配置了一个react-hot加载器,通过它,可以实现对react组件的热替换。我们已经在entry参数中配置了webpack/hot/only-dev-server,所以我们只要在启动webpack开发服务器时开启–hot参数,就可以使用react-hot-loader了。在package.json文件中这样定义:

"scripts": {
     "start": "webpack-dev-server --hot --progress --colors",
     "build": "webpack --progress --colors"
 }

4.resolve 
webpack在构建包的时候会按目录的进行文件的查找,resolve属性中的extensions数组中用于配置程序可以自行补全哪些文件后缀:

resolve:{
     extensions:['','.js','.json']
 }

然后我们想要加载一个js文件时,只要require(‘common’)就可以加载common.js文件了。

6.externals 
当我们想在项目中require一些其他的类库或者API,而又不想让这些类库的源码被构建到运行时文件中,这在实际开发中很有必要。此时我们就可以通过配置externals参数来解决这个问题:

externals: {
     "jquery": "jQuery"
 }

这样我们就可以放心的在项目中使用这些API了:var jQuery = require(“jquery”);

  

 

 

posted @ 2017-02-13 14:15  shuiyun  阅读(225)  评论(0编辑  收藏  举报