1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384 |
- <!DOCTYPE HTML>
- <html lang="zh-hans" >
- <head>
- <meta charset="UTF-8">
- <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
- <title>2-2 Output · 深入浅出 Webpack</title>
- <meta http-equiv="X-UA-Compatible" content="IE=edge" />
- <meta name="description" content="">
- <meta name="generator" content="GitBook 3.2.3">
- <meta name="author" content="吴浩麟">
- <meta name="identifier" content="9787121331725" scheme="ISBN">
-
-
- <link rel="stylesheet" href="../gitbook/style.css">
-
-
-
- <link rel="stylesheet" href="../gitbook/gitbook-plugin-modal/index.css">
-
-
-
- <link rel="stylesheet" href="../gitbook/gitbook-plugin-highlight/website.css">
-
-
-
- <link rel="stylesheet" href="../gitbook/gitbook-plugin-search/search.css">
-
-
-
- <link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- <meta name="HandheldFriendly" content="true"/>
- <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
- <meta name="apple-mobile-web-app-capable" content="yes">
- <meta name="apple-mobile-web-app-status-bar-style" content="black">
- <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
- <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">
-
- <link rel="next" href="2-3Module.html" />
-
-
- <link rel="prev" href="2-1Entry.html" />
-
- <style>
- @media only screen and (max-width: 640px) {
- .book-header .hidden-mobile {
- display: none;
- }
- }
- </style>
- <script>
- window["gitbook-plugin-github-buttons"] = {"buttons":[{"user":"gwuhaolin","type":"follow","size":"small","width":"150"},{"user":"gwuhaolin","repo":"dive-into-webpack","type":"star","size":"small"}]};
- </script>
- </head>
- <body>
-
- <div class="book">
- <div class="book-summary">
-
-
- <div id="book-search-input" role="search">
- <input type="text" placeholder="输入并搜索" />
- </div>
-
- <nav role="navigation">
-
- <ul class="summary">
-
-
-
-
-
-
- <li class="chapter " data-level="1.1" data-path="../">
-
- <a href="../">
-
-
- 深入浅出 Webpack
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.2" data-path="../前言.html">
-
- <a href="../前言.html">
-
-
- 前言
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.3" data-path="../1入门/">
-
- <a href="../1入门/">
-
-
- 第1章 入门
-
- </a>
-
-
- <ul class="articles">
-
- <li class="chapter " data-level="1.3.1" data-path="../1入门/1-1前端的发展.html">
-
- <a href="../1入门/1-1前端的发展.html">
-
-
- 1-1 前端的发展
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.3.2" data-path="../1入门/1-2常见的构建工具及对比.html">
-
- <a href="../1入门/1-2常见的构建工具及对比.html">
-
-
- 1-2 常见的构建工具及对比
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.3.3" data-path="../1入门/1-3安装与使用.html">
-
- <a href="../1入门/1-3安装与使用.html">
-
-
- 1-3 安装与使用
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.3.4" data-path="../1入门/1-4使用Loader.html">
-
- <a href="../1入门/1-4使用Loader.html">
-
-
- 1-4 使用 Loader
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.3.5" data-path="../1入门/1-5使用Plugin.html">
-
- <a href="../1入门/1-5使用Plugin.html">
-
-
- 1-5 使用 Plugin
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.3.6" data-path="../1入门/1-6使用DevServer.html">
-
- <a href="../1入门/1-6使用DevServer.html">
-
-
- 1-6 使用 DevServer
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.3.7" data-path="../1入门/1-7核心概念.html">
-
- <a href="../1入门/1-7核心概念.html">
-
-
- 1-7 核心概念
-
- </a>
-
-
- </li>
- </ul>
-
- </li>
- <li class="chapter " data-level="1.4" data-path="./">
-
- <a href="./">
-
-
- 第2章 配置
-
- </a>
-
-
- <ul class="articles">
-
- <li class="chapter " data-level="1.4.1" data-path="2-1Entry.html">
-
- <a href="2-1Entry.html">
-
-
- 2-1 Entry
-
- </a>
-
-
- </li>
- <li class="chapter active" data-level="1.4.2" data-path="2-2Output.html">
-
- <a href="2-2Output.html">
-
-
- 2-2 Output
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.3" data-path="2-3Module.html">
-
- <a href="2-3Module.html">
-
-
- 2-3 Module
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.4" data-path="2-4Resolve.html">
-
- <a href="2-4Resolve.html">
-
-
- 2-4 Resolve
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.5" data-path="2-5Plugins.html">
-
- <a href="2-5Plugins.html">
-
-
- 2-5 Plugins
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.6" data-path="2-6DevServer.html">
-
- <a href="2-6DevServer.html">
-
-
- 2-6 DevServer
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.7" data-path="2-7其它配置项.html">
-
- <a href="2-7其它配置项.html">
-
-
- 2-7 其它配置项
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.8" data-path="2-8整体配置结构.html">
-
- <a href="2-8整体配置结构.html">
-
-
- 2-8 整体配置结构
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.9" data-path="2-9多种配置类型.html">
-
- <a href="2-9多种配置类型.html">
-
-
- 2-9 多种配置类型
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.4.10" data-path="2-10配置总结.html">
-
- <a href="2-10配置总结.html">
-
-
- 2-10 配置总结
-
- </a>
-
-
- </li>
- </ul>
-
- </li>
- <li class="chapter " data-level="1.5" data-path="../3实战/">
-
- <a href="../3实战/">
-
-
- 第3章 实战
-
- </a>
-
-
- <ul class="articles">
-
- <li class="chapter " data-level="1.5.1" data-path="../3实战/3-1使用ES6语言.html">
-
- <a href="../3实战/3-1使用ES6语言.html">
-
-
- 3-1 使用 ES6 语言
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.2" data-path="../3实战/3-2使用TypeScript语言.html">
-
- <a href="../3实战/3-2使用TypeScript语言.html">
-
-
- 3-2 使用 TypeScript 语言
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.3" data-path="../3实战/3-3使用Flow检查器.html">
-
- <a href="../3实战/3-3使用Flow检查器.html">
-
-
- 3-3 使用 Flow 检查器
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.4" data-path="../3实战/3-4使用SCSS语言.html">
-
- <a href="../3实战/3-4使用SCSS语言.html">
-
-
- 3-4 使用 SCSS
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.5" data-path="../3实战/3-5使用PostCSS.html">
-
- <a href="../3实战/3-5使用PostCSS.html">
-
-
- 3-5 使用 PostCSS
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.6" data-path="../3实战/3-6使用React框架.html">
-
- <a href="../3实战/3-6使用React框架.html">
-
-
- 3-6 使用 React 框架
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.7" data-path="../3实战/3-7使用Vue框架.html">
-
- <a href="../3实战/3-7使用Vue框架.html">
-
-
- 3-7 使用 Vue 框架
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.8" data-path="../3实战/3-8使用Angular2框架.html">
-
- <a href="../3实战/3-8使用Angular2框架.html">
-
-
- 3-8 使用 Angular2 框架
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.9" data-path="../3实战/3-9为单页应用生成HTML.html">
-
- <a href="../3实战/3-9为单页应用生成HTML.html">
-
-
- 3-9 为单页应用生成 HTML
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.10" data-path="../3实战/3-10管理多个单页应用.html">
-
- <a href="../3实战/3-10管理多个单页应用.html">
-
-
- 3-10 管理多个单页应用
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.11" data-path="../3实战/3-11构建同构应用.html">
-
- <a href="../3实战/3-11构建同构应用.html">
-
-
- 3-11 构建同构应用
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.12" data-path="../3实战/3-12构建Electron应用.html">
-
- <a href="../3实战/3-12构建Electron应用.html">
-
-
- 3-12 构建 Electron 应用
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.13" data-path="../3实战/3-13构建Npm模块.html">
-
- <a href="../3实战/3-13构建Npm模块.html">
-
-
- 3-13 构建 Npm 模块
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.14" data-path="../3实战/3-14构建离线应用.html">
-
- <a href="../3实战/3-14构建离线应用.html">
-
-
- 3-14 构建离线应用
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.15" data-path="../3实战/3-15搭配NpmScript.html">
-
- <a href="../3实战/3-15搭配NpmScript.html">
-
-
- 3-15 搭配 Npm Script
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.16" data-path="../3实战/3-16检查代码.html">
-
- <a href="../3实战/3-16检查代码.html">
-
-
- 3-16 检查代码
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.17" data-path="../3实战/3-17通过Node.jsAPI启动Webpack.html">
-
- <a href="../3实战/3-17通过Node.jsAPI启动Webpack.html">
-
-
- 3-17 通过 Node.js API 启动 Webpack
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.18" data-path="../3实战/3-18使用WebpackDevMiddleware.html">
-
- <a href="../3实战/3-18使用WebpackDevMiddleware.html">
-
-
- 3-18 使用 Webpack Dev Middleware
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.19" data-path="../3实战/3-19加载图片.html">
-
- <a href="../3实战/3-19加载图片.html">
-
-
- 3-19 加载图片
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.20" data-path="../3实战/3-20加载SVG.html">
-
- <a href="../3实战/3-20加载SVG.html">
-
-
- 3-20 加载SVG
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.21" data-path="../3实战/3-21加载SourceMap.html">
-
- <a href="../3实战/3-21加载SourceMap.html">
-
-
- 3-21 加载 Source Map
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.5.22" data-path="../3实战/3-22实战总结.html">
-
- <a href="../3实战/3-22实战总结.html">
-
-
- 3-22 实战总结
-
- </a>
-
-
- </li>
- </ul>
-
- </li>
- <li class="chapter " data-level="1.6" data-path="../4优化/">
-
- <a href="../4优化/">
-
-
- 第4章 优化
-
- </a>
-
-
- <ul class="articles">
-
- <li class="chapter " data-level="1.6.1" data-path="../4优化/4-1缩小文件搜索范围.html">
-
- <a href="../4优化/4-1缩小文件搜索范围.html">
-
-
- 4-1 缩小文件搜索范围
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.2" data-path="../4优化/4-2使用DllPlugin.html">
-
- <a href="../4优化/4-2使用DllPlugin.html">
-
-
- 4-2 使用 DllPlugin
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.3" data-path="../4优化/4-3使用HappyPack.html">
-
- <a href="../4优化/4-3使用HappyPack.html">
-
-
- 4-3 使用 HappyPack
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.4" data-path="../4优化/4-4使用ParallelUglifyPlugin.html">
-
- <a href="../4优化/4-4使用ParallelUglifyPlugin.html">
-
-
- 4-4 使用 ParallelUglifyPlugin
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.5" data-path="../4优化/4-5使用自动刷新.html">
-
- <a href="../4优化/4-5使用自动刷新.html">
-
-
- 4-5 使用自动刷新
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.6" data-path="../4优化/4-6开启模块热替换.html">
-
- <a href="../4优化/4-6开启模块热替换.html">
-
-
- 4-6 开启模块热替换
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.7" data-path="../4优化/4-7区分环境.html">
-
- <a href="../4优化/4-7区分环境.html">
-
-
- 4-7 区分环境
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.8" data-path="../4优化/4-8压缩代码.html">
-
- <a href="../4优化/4-8压缩代码.html">
-
-
- 4-8 压缩代码
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.9" data-path="../4优化/4-9CDN加速.html">
-
- <a href="../4优化/4-9CDN加速.html">
-
-
- 4-9 CDN 加速
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.10" data-path="../4优化/4-10使用TreeShaking.html">
-
- <a href="../4优化/4-10使用TreeShaking.html">
-
-
- 4-10 使用 Tree Shaking
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.11" data-path="../4优化/4-11提取公共代码.html">
-
- <a href="../4优化/4-11提取公共代码.html">
-
-
- 4-11 提取公共代码
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.12" data-path="../4优化/4-12按需加载.html">
-
- <a href="../4优化/4-12按需加载.html">
-
-
- 4-12 按需加载
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.13" data-path="../4优化/4-13使用Prepack.html">
-
- <a href="../4优化/4-13使用Prepack.html">
-
-
- 4-13 使用 Prepack
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.14" data-path="../4优化/4-14开启ScopeHoisting.html">
-
- <a href="../4优化/4-14开启ScopeHoisting.html">
-
-
- 4-14 开启 Scope Hoisting
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.15" data-path="../4优化/4-15输出分析.html">
-
- <a href="../4优化/4-15输出分析.html">
-
-
- 4-15 输出分析
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.6.16" data-path="../4优化/4-16优化总结.html">
-
- <a href="../4优化/4-16优化总结.html">
-
-
- 4-16 优化总结
-
- </a>
-
-
- </li>
- </ul>
-
- </li>
- <li class="chapter " data-level="1.7" data-path="../5原理/">
-
- <a href="../5原理/">
-
-
- 第5章 原理
-
- </a>
-
-
- <ul class="articles">
-
- <li class="chapter " data-level="1.7.1" data-path="../5原理/5-1工作原理概括.html">
-
- <a href="../5原理/5-1工作原理概括.html">
-
-
- 5-1 工作原理概括
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.7.2" data-path="../5原理/5-2输出文件分析.html">
-
- <a href="../5原理/5-2输出文件分析.html">
-
-
- 5-2 输出文件分析
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.7.3" data-path="../5原理/5-3编写Loader.html">
-
- <a href="../5原理/5-3编写Loader.html">
-
-
- 5-3 编写 Loader
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.7.4" data-path="../5原理/5-4编写Plugin.html">
-
- <a href="../5原理/5-4编写Plugin.html">
-
-
- 5-4 编写 Plugin
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.7.5" data-path="../5原理/5-5调试Webpack.html">
-
- <a href="../5原理/5-5调试Webpack.html">
-
-
- 5-5 调试 Webpack
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.7.6" data-path="../5原理/5-6原理总结.html">
-
- <a href="../5原理/5-6原理总结.html">
-
-
- 5-6 原理总结
-
- </a>
-
-
- </li>
- </ul>
-
- </li>
- <li class="chapter " data-level="1.8" >
-
- <span>
-
-
- 附录
-
- </span>
-
-
- <ul class="articles">
-
- <li class="chapter " data-level="1.8.1" data-path="../附录/常用Loaders.html">
-
- <a href="../附录/常用Loaders.html">
-
-
- 常用 Loaders
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.8.2" data-path="../附录/常用Plugins.html">
-
- <a href="../附录/常用Plugins.html">
-
-
- 常用 Plugins
-
- </a>
-
-
- </li>
- <li class="chapter " data-level="1.8.3" data-path="../附录/其它Webpack学习资源.html">
-
- <a href="../附录/其它Webpack学习资源.html">
-
-
- 其它 Webpack 学习资源
-
- </a>
-
-
- </li>
- </ul>
-
- </li>
-
- <li class="divider"></li>
- <li id="codefund_ad">
- <script src="https://codesponsor.io/scripts/5da524c5-301a-4ef4-8b42-696edd22e693/embed.js"></script>
- </li>
- </ul>
- </nav>
-
-
- </div>
- <div class="book-body">
-
- <div class="body-inner">
-
-
- <div class="book-header" role="navigation">
-
- <!-- Title -->
- <h1>
- <i class="fa fa-circle-o-notch fa-spin"></i>
- <a href=".." >2-2 Output</a>
- </h1>
- </div>
- <div class="page-wrapper" tabindex="-1" role="main">
- <div class="page-inner">
-
- <div id="book-search-results">
- <div class="search-noresults">
-
- <section class="normal markdown-section">
-
- <h1 id="2-2-output">2-2 Output</h1>
- <p><code>output</code> 配置如何输出最终想要的代码。<code>output</code> 是一个 <code>object</code>,里面包含一系列配置项,下面分别介绍它们。</p>
- <h2 id="filename">filename</h2>
- <p><code>output.filename</code> 配置输出文件的名称,为string 类型。
- 如果只有一个输出文件,则可以把它写成静态不变的:</p>
- <pre><code class="lang-js">filename: <span class="hljs-string">'bundle.js'</span>
- </code></pre>
- <p>但是在有多个 Chunk 要输出时,就需要借助模版和变量了。前面说到 Webpack 会为每个 Chunk取一个名称,可以根据 Chunk 的名称来区分输出的文件名:</p>
- <pre><code class="lang-js">filename: <span class="hljs-string">'[name].js'</span>
- </code></pre>
- <p>代码里的 <code>[name]</code> 代表用内置的 <code>name</code> 变量去替换<code>[name]</code>,这时你可以把它看作一个字符串模块函数,
- 每个要输出的 Chunk 都会通过这个函数去拼接出输出的文件名称。</p>
- <p>内置变量除了 <code>name</code> 还包括:</p>
- <table>
- <thead>
- <tr>
- <th>变量名</th>
- <th>含义</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>id</td>
- <td>Chunk 的唯一标识,从0开始</td>
- </tr>
- <tr>
- <td>name</td>
- <td>Chunk 的名称</td>
- </tr>
- <tr>
- <td>hash</td>
- <td>Chunk 的唯一标识的 Hash 值</td>
- </tr>
- <tr>
- <td>chunkhash</td>
- <td>Chunk 内容的 Hash 值</td>
- </tr>
- </tbody>
- </table>
- <p>其中 <code>hash</code> 和 <code>chunkhash</code> 的长度是可指定的,<code>[hash:8]</code> 代表取8位 Hash 值,默认是20位。</p>
- <blockquote>
- <p>注意 <a href="https://github.com/webpack-contrib/extract-text-webpack-plugin" target="_blank">ExtractTextWebpackPlugin</a> 插件是使用 <code>contenthash</code> 来代表哈希值而不是 <code>chunkhash</code>,
- 原因在于 ExtractTextWebpackPlugin 提取出来的内容是代码内容本身而不是由一组模块组成的 Chunk。</p>
- </blockquote>
- <h2 id="chunkfilename">chunkFilename</h2>
- <p><code>output.chunkFilename</code> 配置无入口的 Chunk 在输出时的文件名称。
- chunkFilename 和上面的 filename 非常类似,但 chunkFilename 只用于指定在运行过程中生成的 Chunk 在输出时的文件名称。
- 常见的会在运行时生成 Chunk 场景有在使用 CommonChunkPlugin、使用 <code>import('path/to/module')</code> 动态加载等时。
- chunkFilename 支持和 filename 一致的内置变量。</p>
- <h2 id="path">path</h2>
- <p><code>output.path</code> 配置输出文件存放在本地的目录,必须是 string 类型的绝对路径。通常通过 Node.js 的 <code>path</code> 模块去获取绝对路径:</p>
- <pre><code class="lang-js">path: path.resolve(__dirname, <span class="hljs-string">'dist_[hash]'</span>)
- </code></pre>
- <h2 id="publicpath">publicPath</h2>
- <p>在复杂的项目里可能会有一些构建出的资源需要异步加载,加载这些异步资源需要对应的 URL 地址。</p>
- <p><code>output.publicPath</code> 配置发布到线上资源的 URL 前缀,为string 类型。
- 默认值是空字符串 <code>''</code>,即使用相对路径。</p>
- <p>这样说可能有点抽象,举个例子,需要把构建出的资源文件上传到 CDN 服务上,以利于加快页面的打开速度。配置代码如下:</p>
- <pre><code class="lang-js">filename:<span class="hljs-string">'[name]_[chunkhash:8].js'</span>
- publicPath: <span class="hljs-string">'https://cdn.example.com/assets/'</span>
- </code></pre>
- <p>这时发布到线上的 HTML 在引入 JavaScript 文件时就需要:</p>
- <pre><code class="lang-html"><span class="hljs-tag"><<span class="hljs-name">script</span> <span class="hljs-attr">src</span>=<span class="hljs-string">'https://cdn.example.com/assets/a_12345678.js'</span>></span><span class="undefined"></span><span class="hljs-tag"></<span class="hljs-name">script</span>></span>
- </code></pre>
- <p>使用该配置项时要小心,稍有不慎将导致资源加载404错误。</p>
- <p><code>output.path</code> 和 <code>output.publicPath</code> 都支持字符串模版,内置变量只有一个:<code>hash</code> 代表一次编译操作的 Hash 值。</p>
- <h2 id="crossoriginloading">crossOriginLoading</h2>
- <p>Webpack 输出的部分代码块可能需要异步加载,而异步加载是通过 <a href="https://zh.wikipedia.org/wiki/JSONP" target="_blank">JSONP</a> 方式实现的。
- JSONP 的原理是动态地向 HTML 中插入一个 <code><script src="url"></script></code> 标签去加载异步资源。
- <code>output.crossOriginLoading</code> 则是用于配置这个异步插入的标签的 <code>crossorigin</code> 值。</p>
- <p>script 标签的 crossorigin 属性可以取以下值:</p>
- <ul>
- <li><code>anonymous</code>(默认) 在加载此脚本资源时不会带上用户的 Cookies;</li>
- <li><code>use-credentials</code> 在加载此脚本资源时会带上用户的 Cookies。</li>
- </ul>
- <p>通常用设置 crossorigin 来获取异步加载的脚本执行时的详细错误信息。</p>
- <h2 id="librarytarget-和-library">libraryTarget 和 library</h2>
- <p>当用 Webpack 去构建一个可以被其他模块导入使用的库时需要用到它们。</p>
- <ul>
- <li><code>output.libraryTarget</code> 配置以何种方式导出库。</li>
- <li><code>output.library</code> 配置导出库的名称。</li>
- </ul>
- <p>它们通常搭配在一起使用。</p>
- <p><code>output.libraryTarget</code> 是字符串的枚举类型,支持以下配置。</p>
- <h3 id="var-默认">var (默认)</h3>
- <p>编写的库将通过 <code>var</code> 被赋值给通过 <code>library</code> 指定名称的变量。</p>
- <p>假如配置了 <code>output.library='LibraryName'</code>,则输出和使用的代码如下:</p>
- <pre><code class="lang-js"><span class="hljs-comment">// Webpack 输出的代码</span>
- <span class="hljs-keyword">var</span> LibraryName = lib_code;
- <span class="hljs-comment">// 使用库的方法</span>
- LibraryName.doSomething();
- </code></pre>
- <p>假如 <code>output.library</code> 为空,则将直接输出:</p>
- <pre><code class="lang-js">lib_code
- </code></pre>
- <blockquote>
- <p>其中 <code>lib_code</code> 代指导出库的代码内容,是有返回值的一个自执行函数。</p>
- </blockquote>
- <h3 id="commonjs">commonjs</h3>
- <p>编写的库将通过 CommonJS 规范导出。</p>
- <p>假如配置了 <code>output.library='LibraryName'</code>,则输出和使用的代码如下:</p>
- <pre><code class="lang-js"><span class="hljs-comment">// Webpack 输出的代码</span>
- exports[<span class="hljs-string">'LibraryName'</span>] = lib_code;
- <span class="hljs-comment">// 使用库的方法</span>
- <span class="hljs-built_in">require</span>(<span class="hljs-string">'library-name-in-npm'</span>)[<span class="hljs-string">'LibraryName'</span>].doSomething();
- </code></pre>
- <blockquote>
- <p>其中 <code>library-name-in-npm</code> 是指模块发布到 Npm 代码仓库时的名称。</p>
- </blockquote>
- <h3 id="commonjs2">commonjs2</h3>
- <p>编写的库将通过 CommonJS2 规范导出,输出和使用的代码如下:</p>
- <pre><code class="lang-js"><span class="hljs-comment">// Webpack 输出的代码</span>
- <span class="hljs-built_in">module</span>.exports = lib_code;
- <span class="hljs-comment">// 使用库的方法</span>
- <span class="hljs-built_in">require</span>(<span class="hljs-string">'library-name-in-npm'</span>).doSomething();
- </code></pre>
- <blockquote>
- <p>CommonJS2 和 CommonJS 规范很相似,差别在于 CommonJS 只能用 <code>exports</code> 导出,而 CommonJS2 在 CommonJS 的基础上增加了 <code>module.exports</code> 的导出方式。</p>
- <p>在 <code>output.libraryTarget</code> 为 <code>commonjs2</code> 时,配置 <code>output.library</code> 将没有意义。</p>
- </blockquote>
- <h3 id="this">this</h3>
- <p>编写的库将通过 <code>this</code> 被赋值给通过 <code>library</code> 指定的名称,输出和使用的代码如下:</p>
- <pre><code class="lang-js"><span class="hljs-comment">// Webpack 输出的代码</span>
- <span class="hljs-keyword">this</span>[<span class="hljs-string">'LibraryName'</span>] = lib_code;
- <span class="hljs-comment">// 使用库的方法</span>
- <span class="hljs-keyword">this</span>.LibraryName.doSomething();
- </code></pre>
- <h3 id="window">window</h3>
- <p>编写的库将通过 <code>window</code> 被赋值给通过 <code>library</code> 指定的名称,即把库挂载到 <code>window</code> 上,输出和使用的代码如下:</p>
- <pre><code class="lang-js"><span class="hljs-comment">// Webpack 输出的代码</span>
- <span class="hljs-built_in">window</span>[<span class="hljs-string">'LibraryName'</span>] = lib_code;
- <span class="hljs-comment">// 使用库的方法</span>
- <span class="hljs-built_in">window</span>.LibraryName.doSomething();
- </code></pre>
- <h3 id="global">global</h3>
- <p>编写的库将通过 <code>global</code> 被赋值给通过 <code>library</code> 指定的名称,即把库挂载到 <code>global</code> 上,输出和使用的代码如下:</p>
- <pre><code class="lang-js"><span class="hljs-comment">// Webpack 输出的代码</span>
- global[<span class="hljs-string">'LibraryName'</span>] = lib_code;
- <span class="hljs-comment">// 使用库的方法</span>
- global.LibraryName.doSomething();
- </code></pre>
- <h2 id="libraryexport">libraryExport</h2>
- <p><code>output.libraryExport</code> 配置要导出的模块中哪些子模块需要被导出。
- 它只有在 <code>output.libraryTarget</code> 被设置成 <code>commonjs</code> 或者 <code>commonjs2</code> 时使用才有意义。</p>
- <p>假如要导出的模块源代码是:</p>
- <pre><code class="lang-js"><span class="hljs-keyword">export</span> <span class="hljs-keyword">const</span> a=<span class="hljs-number">1</span>;
- <span class="hljs-keyword">export</span> <span class="hljs-keyword">default</span> b=<span class="hljs-number">2</span>;
- </code></pre>
- <p>现在你想让构建输出的代码只导出其中的 <code>a</code>,可以把 <code>output.libraryExport</code> 设置成 <code>a</code>,那么构建输出的代码和使用方法将变成如下:</p>
- <pre><code class="lang-js"><span class="hljs-comment">// Webpack 输出的代码</span>
- <span class="hljs-built_in">module</span>.exports = lib_code[<span class="hljs-string">'a'</span>];
- <span class="hljs-comment">// 使用库的方法</span>
- <span class="hljs-built_in">require</span>(<span class="hljs-string">'library-name-in-npm'</span>)===<span class="hljs-number">1</span>;
- </code></pre>
- <blockquote>
- <p>以上只是 <code>output</code> 里常用的配置项,还有部分几乎用不上的配置项没有一一列举,你可以在 <a href="https://webpack.js.org/configuration/output/" target="_blank">Webpack 官方文档</a> 上查阅它们。</p>
- </blockquote>
-
- </section>
-
- </div>
- <div class="search-results">
- <div class="has-results">
-
- <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
- <ul class="search-results-list"></ul>
-
- </div>
- <div class="no-results">
-
- <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
-
- </div>
- </div>
- </div>
- </div>
- </div>
-
- </div>
-
-
- <a href="2-1Entry.html" class="navigation navigation-prev " aria-label="Previous page: 2-1 Entry">
- <i class="fa fa-angle-left"></i>
- </a>
-
-
- <a href="2-3Module.html" class="navigation navigation-next " aria-label="Next page: 2-3 Module">
- <i class="fa fa-angle-right"></i>
- </a>
-
-
-
- </div>
- <script>
- var gitbook = gitbook || [];
- gitbook.push(function() {
- gitbook.page.hasChanged({"page":{"title":"2-2 Output","level":"1.4.2","depth":2,"next":{"title":"2-3 Module","level":"1.4.3","depth":2,"path":"2配置/2-3Module.md","ref":"2配置/2-3Module.md","articles":[]},"previous":{"title":"2-1 Entry","level":"1.4.1","depth":2,"path":"2配置/2-1Entry.md","ref":"2配置/2-1Entry.md","articles":[]},"dir":"ltr"},"config":{"plugins":["github-buttons","ga","modal","adsense"],"root":"./docs","styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"search":{},"adsense":{"client":"ca-pub-9697944574373240","slot":"9319793387","format":"auto","element":".page-inner section","position":"top"},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"modal":{"closable":true,"excludeUrls":["\\?q=.+$","index.html","前言.html","\\/$","1-.+","2-2Output","3-1使用ES6语言","3-2使用TypeScript语言","3-4使用SCSS语言.html","3-5使用PostCSS.html","3-6使用React框架","3-7使用Vue框架","3-8使用Angular2框架","3-9为单页应用生成HTML","3-10管理多个单页应用","3-17通过Node.jsAPI启动Webpack","3-20加载SVG"],"html":"<div style='text-align: center'><a href='http://union-click.jd.com/jdc?d=1AMcaz'><img src='http://p0.meituan.net/scarlett/df16c51ffb95186df6f75d8c0e22b965842464.png' width='306px' height='411px'><a/> <h2><a target='_blank' href='http://union-click.jd.com/jdc?d=1AMcaz'>购买本书纸质版</a></h2></div>"},"fontsettings":{"theme":"white","family":"sans","size":2},"highlight":{},"github-buttons":{"buttons":[{"user":"gwuhaolin","type":"follow","size":"small","width":"150"},{"user":"gwuhaolin","repo":"dive-into-webpack","type":"star","size":"small"}]},"ga":{"configuration":"auto","token":"UA-54964850-3"},"sharing":{"facebook":false,"twitter":false,"google":false,"weibo":true,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"吴浩麟","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"isbn":"9787121331725","variables":{},"title":"深入浅出 Webpack","language":"zh-hans","gitbook":"*","description":"本书按照入门、配置、实战、优化、原理的路线层层深入,涵盖了 Webpack 的方方面面。对于小白,本书可以作为 Webpack 入门教程,对于老手,本书可以进一步加深你对 Webpack 的理解。"},"file":{"path":"2配置/2-2Output.md","mtime":"2018-01-19T02:14:18.396Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-03-17T07:14:49.167Z"},"basePath":"..","book":{"language":""}});
- });
- </script>
- </div>
-
- <script src="../gitbook/gitbook.js"></script>
- <script src="../gitbook/theme.js"></script>
-
-
- <script src="../gitbook/gitbook-plugin-github-buttons/plugin.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-ga/plugin.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-modal/index.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-adsense/plugin.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-search/search-engine.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-search/search.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
-
-
-
- <script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
-
-
- </body>
- </html>
|