教你如何读webpack2中文文档

[lcxfs1991]

经过一个多月的奋战，webpack2的中文文档已经翻译好大部份，并且完成了核心内容“概念”和“指南”部份的校对。

这份文档比react, vue之类的文档都要庞大而且复杂。本文带你如何快速读懂这份文档。

首先是“概念”。这部份对于菜鸟或者老司机来说，都是值得一读的，由于webpack跟之前的grunt, gulp都有所不同，它是基于模块的配置型构建工具，许多理念对于前端玩家来说都是全新的，例如，什么是入口(entry)，它有几种配置的方式，如何配置我们需要输出(output)的位置、文件名，加载器(loaders)，和插件(plugins)是如何帮助我们编译文件和处理各种自动化任务的，webpack要打包的模块(module)到底是什么，它去哪里解析(resolve)文件等等，这里都会帮你一一解答。

在你了解了webpack的概念之后，接下来，可以看看“指南”。这里的内容都是实践经验之谈，例如前四篇文章主要是介绍怎么用webpack去初始化一个项目，并进行发布；《从v1迁移到v2》帮助你顺利从webpack1升级至webpack2。其它的文档，主要是介绍webpack一些比较精彩的特性，例如拆包、热替换等等，还有一些比较有趣的，像怎么用typescript写webpack配置，怎么用虚拟机跑webpack等等。

如果你对前两部份都了如指掌，那么恭喜你，你已经具备能力进入webpack的深水区了--更为细致的"文档"了。

点击”文档“，首先进入的是"配置"，这里算是完整配置的介绍，要搭建一个更为完善的脚手架或者构建工具，需要仔细阅读这里的配置文档。

“API”主要介绍了像webpack命令行的使用、如何在Node.js中结合webpack来搭建构建工具。对比起webpack1，webpack2的命令行工具变得更为强大，而且可以对你的构建耗时进行分析。

API中另外的两部份，“加载器API”和“插件API”，可以结合“开发”部份来看，主要是帮助开发者更好地开发webpack的加载器和插件，借助webpack的能力去解决自身项目中遇到的构建问题。对比webpack1，这是一份更好的加载器和插件开发文档，因为它不仅介绍了推荐的写法，还把内部的事件、内部可调用的一些方法，都展现了出来，赋予了开发者更多的能力。

webpack2的文档，耗费了许多人大量的心血，尤其要感谢最开始启动这个翻译项目的dear-lizhihua 还有 dingyiming，webpack中文社区的几位筹办成员，还有许多贡献本项目的热心技术同仁。

如果想参与我们的翻译项目，请关注我们的官方文档翻译计划。

如果有webpack相关的技术文章，可以在awesome-webpack-cn给我们提pull request。

如果有兴趣参与社区筹办，请关注我们的harpers项目。

我们会持续关注webpack，关注前端工程化发展的方方面面。

By AlloyTeam LeeHey,

webpack-china首席打杂

于2017.2.25，一个寒冷的春夜

[MeCKodo]

十分感谢，辛勤的付出

[CommanderXL]

感谢感谢

[chenbin92]

赞，webpack v2 的文档比 v1 好很多

[adoyle-h]

赞！感谢辛勤付出

[adntin]

感谢你们的付出!

[GeoffZhu]

感谢

[mujiatong]

Many Thanks.

[benmo1602]

作为小白 十分感谢你们，辛苦了

[wugang168]

给你们点赞

[koucxz]

十分感谢

[zymt]

正在看，相信会有收获！

[zidian257]

点赞！

[kumayato]

谢谢！！！

[91Cola]

非常感谢，腾讯的兄弟

[zhaiqianfeng]

辛辛苦苦啃了这么久的英文，也做了些翻译！原来大伙都在这．汗~~~

[lcxfs1991]

@zhaiqianfeng 如果有兴趣，可以加入webpack-china的翻译。

[chenchenyuyu]

感谢，看到中文，好感动

[laoergege]

正要学习webpack，非常感谢你们提供这么大的帮助！

[devinRex]

感谢付出

[didilinkin]

感谢！！！

[LeeRayno]

感谢，我没事了就会去你们 AlloyTeam 网站逛逛学习学习

[manfwh]

感谢你们的付出

[bowtieRanting]

感谢为中文开发者做出的贡献

[zhuwei78]

感谢你们的付出！谢谢！

[cdscawd]

👍

[wwb568109135]

辛苦辛苦，大大的赞！

[vajsp]

辛苦啦~！

[guyunxiang]

指南部分，模块热替换。翻译的的有问题，译者自己删改示例代码成伪代码，不利于理解，导致示例无法运行，对应文案也自我想当然口语化表达，不适合用作指南。

[EvanEest]

感谢，么么哒！

[chen86860]

辛苦，谢谢了 :D

[hanzhangyu]

thanks

[f1084]

大佬们辛苦了 --simle

[MoGoethe]

膜拜大佬

[oroz-vip]

艾玛去慕课网看了个webpack的视频，结果代码到了我这里好多都失效了，配置文件都不对，去啃了好一会英文官网，英文不太好，难咽，终于找到了这里

[Randysheng]

感谢

[yondmn]

十分感谢，对我特别有帮助

[wanglq80]

谢谢！

[robert7git]

谢谢

[Randysheng]

thanks

[qq406601626]

3Q~