Webpack 5 在整体架构上做了大量优化，其中 Perseverance 坚持作为一项底层设计理念，主要作用于模块解析与缓存系统。它改变了旧版本中遇到非致命错误就直接抛错退出的行为，让构建过程具备一定的容错与持续执行能力。
Perseverance 坚持的核心含义
在 Webpack 5 的语境下，Perseverance 坚持指的是构建引擎在遭遇可恢复的异常时，不轻易放弃整个编译任务，而是记录中断点、保留已生成的缓存，并持续尝试完成剩余工作。例如当某个远程依赖暂时拉取失败，或者某文件夹因系统锁被短暂占用，Webpack 5 会将其标记为待重试模块，而不是让整次构建崩溃。
这种设计区别于传统打包工具“遇到错误就停止”的刚性逻辑。它更接近人类处理复杂任务时的坚持态度：先做能做的部分，把卡住的地方留待条件恢复后再补。对开发者而言，这意味着在 CI 环境或弱网条件下，构建成功率会明显提高，不必因为一次超时就得重跑几分钟甚至几十分钟的打包。
Perseverance 在模块解析中的表现
模块解析阶段是 Perseverance 发挥作用的主要场景。Webpack 5 增强了 resolver 的缓存与重试机制，对于 alias 指向的动态路径、monorepo 中的软链接包，以及通过 webpack resolve.fallback 配置的兼容模块，都会在首次解析失败后写入临时索引，后续轮询中自动复用成功结果。
举个实际例子，在一个包含三百个本地包的工程里，如果某个包的符号链接在构建瞬间被其他进程改写，Webpack 4 往往会直接报模块未找到并退出。而开启 Perseverance 思路的 Webpack 5，会先跳过该包并继续处理其余文件，待链接稳定后通过缓存补算依赖图，最终产出完整 bundle。这样既节省了时间，也降低了人工介入频率。
与持久化缓存的关系
Perseverance 坚持和 Webpack 5 的持久化缓存（filesystem cache）是相辅相成的。缓存把中间产物落盘，坚持机制则保证落盘动作不被偶发异常打断。两者结合后，即便构建机在打包中途重启，再次启动时也能从已有缓存恢复，而不是从零开始。
在配置上，通常通过 cache 选项开启持久化，而 Perseverance 更多是内部默认策略，不过我们可以通过 stats 配置更详细地输出哪些模块经历了重试，从而判断工程里是否存有不稳定依赖。
如何观察与调优 Perseverance 行为
虽然 Perseverance 是内建特性，但我们仍可通过日志与统计来观察其效果。在命令行加入 --stats verbose 或使用 stats 配置中的模块重试字段，能看到类似“module retried due to temporary miss”的记录。如果这类记录过多，说明项目里存在高频不稳定路径，需要检查文件系统或网络。
另外，在 webpack.config.js 中合理设置 snapshot 策略，可以控制 Webpack 对文件状态的检查粒度。粒度太细会增加重试判断开销，太粗则可能漏掉真实变化。经验上，源码目录用时间戳快照，第三方包用内容哈希快照，能让坚持机制更高效地运转。
| 对比维度 | Webpack 4 默认行为 | Webpack 5 Perseverance 思路 |
|---|---|---|
| 解析失败处理 | 直接报错退出 | 标记待重试并继续 |
| 缓存中断风险 | 易因异常丢失 | 保留断点后续补算 |
| 弱网构建成功率 | 较低 | 明显提升 |
常见误区与正确使用方式
有人认为 Perseverance 会让所有错误都被静默忽略，其实不然。它只针对可恢复的非致命异常，对于语法错误、配置错误这类必须人工修正的问题，Webpack 5 依然会明确失败。坚持不是掩盖问题，而是避免环境噪声干扰正常构建。
日常使用中，我们不必专门写代码开启它，但应当保证 cache 目录有稳定读写权限，并避免在构建脚本里用 kill -9 强行终止进程，否则坚持机制来不及保存进度。理解这一点，才能让 Webpack 5 的新特性真正服务于效率提升。
Webpack5Perseverance模块打包修改时间：2026-08-10 22:51:29