16

准备

  1. 下载Node.js和npm

  2. 一个命令行工具(我的是git bash)。不是必须的,用自带的命令行也可以。

  3. 创建一个文件夹,作为根目录,比如 npm-webpack-es6

这时,你将看到一个空文件夹

开始

  1. 命令行打开至根目录

  2. 键入 npm init,一路确定到yes ————————创建一个package.json。

clipboard.png 文件夹如左

clipboard.png package.json 内部如左

安装webpack

安装webpack前,先附上几个常用的npm命令


npm init      这个指令会引导你创建一个package.json,包括版本作者等信息,有助于你发包。后面安装的包的依赖关系也会在package.json里有体现。
npm install     直接执行这个命令,会按照当前目录下的package.json的配置去安装各个依赖的包。
npm install [module]    在当前目录安装这个模块。会去检测该模块是否存在于node_module文件夹中,存在了就不安装了。 
npm install [module] -g    在全局进行模块安装。全局模式下安装的包,会自动注册到系统变量 path里的。
npm install [module] --save-dev    在当前目录下安装这个模块,但是仅在开发时使用。在package的"devDependencies"下,表示仅在开发的时候使用。

有一些包是需要用命令行的,这些需要注册系统变量,因此像supervisor等包,一定要安装在全局。否则就不能用它的命令行指令。
有一些包是在js中使用的,那么这些包安装到当前目录就可以了。
webpack 一般建议全局安一个,当前目录安一个。

我们刚才已经使用了npm init创建了一个package.json,接下来我们开始安装webpack。

首先在全局安装一个webpack

执行 npm install webpack -g         (已经全局安装webpack 的可以跳过这一步)

然后在当前目录下安装一个webpack

执行 npm install webpack --save

你会发现当前目录下新增了一个文件夹node_module,在里头有着webpack的包

检验下,webpack 安装成功了没

执行  webpack -v

如果webpack安装成功了,就会在命令行打印出webpack的版本和帮助。
如果失败了,检测一下有没有在全局安装webpack。

当你执行到这步,你的文件夹长这个样子

   --npm-webpack-es6
        --package.json
        --node_module
            --webpack

package.json长这个样子

{
  "name": "npm-webpack-es6",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "webpack": "^1.13.2"
  }
}

使用webpack来组织文件

在直接介绍使用es6模块化语言来组织文件之前,我们先了解一下webpack的使用。
webpack会将我们用模块化语言语法写成的源文件,编译成浏览器可识别的文件。也就是有从源文件→线上文件的过程。

我们来实践一下:

  • 首先在根目录下创建一个文件夹src来放源文件;

  • 再创建一个文件夹dist来放编译后文件;

  • 新建一个html文件来放html文件

  • 最后创建一个webpack.config.js。 (先创个空的,待会儿加内容)

这时你的目录结构将如下:

clipboard.png

webpack.config.js是webpack的配置文件。
要搞懂webpack其实就是要懂得怎么来配置 webpack.config.js。
本文介绍一个基础的配置,完整的配置教程请参照官网文档——webpack官网文档

接下来:

  • 在src中新建一个文件—— sourceFile.js

    文件内容,随意点:

//sourceFile.js
console.log('我是superman');
  • 配置 webpack.config.js (关键一步)

module.exports = {
    entry:{
        bundle : __dirname + '/src/sourceFile.js' 
    },
    output:{
        path: __dirname + '/dist',
        filename: '[name].js'
    }
}

这个文件仅有entry和output,应该是最简单的配置文件了。

  1. module.exports 是CommonJS的写法,这个是Node.js的规范

  2. __dirname 代表当前目录,Node.js会去识别

  3. entry中,值为一个路径,代表源文件的存放位置。键,则可以随便取,在我的配置中,编译后文件的名字就是这里的键。

  4. output中,path为编译后的文件存放的文件夹。 filename 为编译后文件夹名字。 其中[name]代表了entry中的键。也就是说上面是什么名字,编译后就是什么名字。可以自己试验下。


  • 使用webpack进行编译

    在命令行键入 webpack -w            
    

成功编译的话,命令行的显示

clipboard.png

同时在dist中会新出现一个 bundle.js, 代码长这个样子:

/******/ (function(modules) { // webpackBootstrap
/******/     // The module cache
/******/     var installedModules = {};

/******/     // The require function
/******/     function __webpack_require__(moduleId) {

/******/         // Check if module is in cache
/******/         if(installedModules[moduleId])
/******/             return installedModules[moduleId].exports;

/******/         // Create a new module (and put it into the cache)
/******/         var module = installedModules[moduleId] = {
/******/             exports: {},
/******/             id: moduleId,
/******/             loaded: false
/******/         };

/******/         // Execute the module function
/******/         modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);

/******/         // Flag the module as loaded
/******/         module.loaded = true;

/******/         // Return the exports of the module
/******/         return module.exports;
/******/     }


/******/     // expose the modules object (__webpack_modules__)
/******/     __webpack_require__.m = modules;

/******/     // expose the module cache
/******/     __webpack_require__.c = installedModules;

/******/     // __webpack_public_path__
/******/     __webpack_require__.p = "";

/******/     // Load entry module and return exports
/******/     return __webpack_require__(0);
/******/ })
/************************************************************************/
/******/ ([
/* 0 */
/***/ function(module, exports) {

    console.log('我是superman');

/***/ }
/******/ ]);

可以看到编译后的js多了很多额外的内容,所以如果项目小的话是不需要模块化的。模块化是用来构建中大型项目的。

来看看效果

  • 在html文件夹下新建一个 test.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>看看我们编译后的js可不可以用</title>
</head>
<body>
    <script src = "../dist/bundle.js"></script>
</body>
</html>

在浏览器打开test.html,你会看到浏览器的console中:

clipboard.png

说明我们将源文件sourceFile.js编译后生成的bundle.js,是可以正常使用的。

疑惑

 这样子做的话,和html中直接引用源文件效果是一样的啊。话说为什么要编译啊?这样不是更麻烦吗?

这是我刚接触webpack的感受。后来,我逐步理解了,编译其实是为了实现模块化。基于AMD/CMD/CommonJS/es6的语法,浏览器是无法识别的。这些规范的语法,你可以感受一下:

 //AMD
require(['moduleA', 'moduleB', 'moduleC'], function (moduleA, moduleB, moduleC)
{
    alert('加载成功');
});

//CMD
seajs.use("../static/hello/src/main")

//CommonJS
module.export = {
    name:'rouwan'
}

//es6模块
import {module1, module2} form './module.js';

这些规范使用的语法,浏览器是不能识别的。不信你试一下,立马报错。除非未来几年,浏览器支持es2015的import和export。因此,需要由webpack来编译,编译后的文件,浏览器能够识别。

现在,我们开始使用es6模块语法来组织模块吧

使用es6模块语法

webpack可以支持es6语法。这个也是为什么webpack强大的原因。用es6a ,想想就爽。
当然,我们需要先下载配置babel

下载和配置babel
下载babel:

npm install --save-dev babel-loader babel-core babel-preset-es2015  //下载babel的webpack加载器

下载完了,要去webpack.config.js进行配置,配置完的文件如下:

module.exports = {
    entry:{
        bundle : __dirname + '/src/sourceFile.js'
    },
    output:{
        path: __dirname + '/dist',
        filename: '[name].js'
    },
    module:{
        loaders:[{
            test: /\.js$/,
            loader: 'babel?presets=es2015'
        }]
    }
}

可以看到,和之前的webpack.config.js相比,增加了一个loaders的配置。
大致意思是:所有的js文件,使用babel加载器来翻译一下
具体配置原理可查官网文档 loader的api

怎么看自己是否配置好呢?待会儿webpack编译时看有没有报错,浏览器端有没有识别es6语法就知道了。

开始使用es6模块
在src文件夹下新建一个文件——moduleTest.js

//moduleTest.js
function say(){
    console.log('我引用了一个模块')
}

export {say}

将sourceFile.js的内容改为:

//sourceFile.js
import {say} from './moduleTest.js';
say();

在命令行运行webpack编译指令

webpack -w

如果没有报错,先开心一下。嘿嘿。
别急,先去打开test.html看看,如果你看到了命令行成功打印

clipboard.png

那么,恭喜你,这个demo完整地跑完了。

结语

前端工程化是大势所趋,我们将不再人工去实现 依赖管理,代码压缩混淆,测试,上线等开发流程,转而交由工具去完成。这些工具中,npm作为优秀的包管理工具,节省了我们在搜索各个库的官网下载库的时间,方便我们进行包的下载,更新,和依赖管理;webpack作为优秀的模块化构建工具,支持多种模块化规范,并能将css/字体/图片作为模块管理,编译各类js方言,有着丰富的插件,已经超出了一个模块加载器的范围,成为了一款强大的前端构建工具。

本文仅仅介绍了一个最简单的demo,因为我也正在学习中。详细的资料,还是要去看文档并实践,这里给出几个传送门以便大家详细了解npm/webpack/es6模块的知识。

npm常用指令
webpack官方文档
阮一峰的ECMA6入门——es6模块


曾广营
1.9k 声望193 粉丝

学习unity、laya、3dmax中