详解webpack 最简打包结果分析
本文以webpack4无配置模式为例,通过创建最简项目并执行打包命令,深入剖析生成的dist/main.js文件结构。重点解析__webpack_require__与__webpack_exports__的作用,以及模块加载、缓存与导出的完整执行流程,帮助开发者理解Webpack底层工作原理。
webpack4 无配置模式简介
如今的 webpack 已大幅简化了入门门槛,过去最令开发者困扰的配置文件问题,在 webpack4 推出无配置模式后得到了显著改善。
在 webpack4 环境下,仅需安装 webpack 和 webpack-cli 即可开始工作。建议读者自行构建一个最简项目,并通过调整插件来对比打包前后的差异,从而直观理解其工作机制。
最简项目构建与打包
完成 npm i webpack webpack-cli -D 安装后,鉴于 webpack4 默认将 src 目录视为入口,因此首先需要创建 src/index.js。
// src/index.js
import { sth } from './shouldImport'
import other from './shouldImport'
let test = 'this is a variable'
export default {
a: test + ',' + sth,
other,
}
为了更清晰地观察 webpack 的模块导入机制,建议额外创建 src/shouldImport.js 文件。
// src/shouldImport.js
export let sth = 'something you need'
export default {
others: '',
}
随后执行 node_modules/.bin/webpack --mode development 命令,即可在 dist 目录下生成 main.js 打包文件。
源码映射配置优化
然而,默认配置下的模块代码会被 eval 包裹,这增加了阅读难度。因此需要调整配置,将 devtool 属性修改为 'source-map' 以优化源码映射。
// 在根目录新建 webpack.config.js 文件
module.exports = mode => {
if (mode === 'production') {
return {}
}
return {
devtool: 'source-map',
}
}
重新打包后,你将看到类似以下结构的结果。开发环境下的打包文件包含注释,有助于理解代码逻辑:
;(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] = {
i: moduleId,
l: false,
exports: {},
})
// Execute the module function
// 执行模块函数(有点不懂为什么 this 要传入 module.exports)
modules[moduleId].call(
module.exports, // this
module, // 模块对象本身
module.exports, // 模块对象的 exports 属性
__webpack_require__ // 请求函数最终返回模块输出,传入用于请求其他模块
)
// Flag the module as loaded
// 加载完成标志
module.l = 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
// Object.prototype.hasOwnProperty.call
__webpack_require__.o = function(object, property) {
return Object.prototype.hasOwnProperty.call(object, property)
}
// define getter function for harmony exports
// 为 ES6 export 定义 getter 函数
__webpack_require__.d = function(exports, name, getter) {
if (!__webpack_require__.o(exports, name)) {
// 检查属性是否存在
Object.defineProperty(exports, name, { enumerable: true, get: getter })
}
}
// define __esModule on exports
// 于 export 定义 __esModule
__webpack_require__.r = function(exports) {
if (typeof Symbol !== 'undefined' && Symbol.toStringTag) {
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
}
Object.defineProperty(exports, '__esModule', { value: true })
}
// create a fake namespace object
// 创建代用命名空间对象
// mode & 1: value is a module id, require it
// value 是模块 id,必要
// mode & 2: merge all properties of value into the ns
// 合并 value 所有属性到 ns
// mode & 4: return value when already ns object
// ns 已经是对象时返回 value
// mode & 8|1: behave like require
// 表现如 require
__webpack_require__.t = function(value, mode) {
if (mode & 1) value = __webpack_require__(value)
if (mode & 8) return value
if (mode & 4 && typeof value === 'object' && value && value.__esModule)
return value
var ns = Object.create(null)
__webpack_require__.r(ns)
Object.defineProperty(ns, 'default', { enumerable: true, value: value })
if (mode & 2 && typeof value != 'string')
for (var key in value)
__webpack_require__.d(
ns,
key,
function(key) {
return value[key]
}.bind(null, key)
)
return ns
}
// getDefaultExport function for compatibility with non-harmony modules
// 用于兼容非 ES6 模块的 getDefaultExport 函数
__webpack_require__.n = function(module) {
var getter =
module && module.__esModule
? function getDefault() {
return module['default']
}
: function getModuleExports() {
return module
}
__webpack_require__.d(getter, 'a', getter)
return getter
}
// __webpack_public_path__
__webpack_require__.p = ''
// Load entry module and return exports
// 加载入口模块并返回 export
return __webpack_require__((__webpack_require__.s = './src/index.js'))
})({
'./src/index.js':
/*! exports provided: default */
function(module, __webpack_exports__, __webpack_require__) {
'use strict'
__webpack_require__.r(__webpack_exports__) // 于 export 定义 __esModule
/* harmony import */
var _shouldImport__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(
'./src/shouldImport.js'
)
let test = 'this is a variable'
/* harmony default export */
__webpack_exports__['default'] = {
a: test + ',' + _shouldImport__WEBPACK_IMPORTED_MODULE_0__['sth'],
other: _shouldImport__WEBPACK_IMPORTED_MODULE_0__['default'],
}
},
'./src/shouldImport.js':
/*! exports provided: sth, default */
function(module, __webpack_exports__, __webpack_require__) {
'use strict'
__webpack_require__.r(__webpack_exports__)
/* harmony export (binding) */
__webpack_require__.d(__webpack_exports__, 'sth', function() {
return sth
})
let sth = 'something you need'
__webpack_exports__['default'] = {
others: '',
}
},
})
打包结果与模块机制解析
源文件中的 import 和 export 语句会被转换为相应的辅助函数处理。
- import 语句对应生成的 __webpack_require__ 函数。
- export 语句则对应 __webpack_exports__['default'] 的直接赋值操作,以及 __webpack_require__.d 函数的调用。
模块加载完整流程
梳理整个打包与加载流程如下:
- 首先定义 __webpack_require__ 函数及其相关的辅助函数。
- 接着使用 __webpack_require__ 引入入口模块。
- __webpack_require__ 函数负责载入模块,并将其存入模块缓存中。
- 调用模块
- 同样利用 __webpack_require__ 读取模块依赖(此过程会递归回到第 3 步)。
- 执行模块内部的功能代码。
- 通过 __webpack_exports__['default'] 直接赋值和 __webpack_require__.d 进行输出。
- 模块运行结束。
以上即为本文的核心内容,希望能为读者的学习提供有益参考,也欢迎大家继续支持本站。
Mock.js 与 MSW、YApi 对比:前端接口模拟工具怎么选
2026-11-04 22:55:05
Turf.js 安装与引入:NPM 打包及 CDN 快速上手指南
2026-11-03 23:23:32
JS代码混淆后无法调试?Source Map配置与浏览器断点技巧
2026-11-03 14:12:17
前端JS发送HTTP请求遇到跨域(CORS)报错怎么解决
2026-11-02 10:30:07
Three.js怎么安装:npm引入与CDN加载方法
2026-11-02 09:23:52
