perf: enable the Node.js compile cache in the CLI entry point - #21523

🦋 Changeset detected

Latest commit: d057a59

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

PR Summary

Low Risk
Startup-only optional optimization with feature detection and swallowed errors; no change to bundling logic or user-facing CLI behavior.

Overview
Enables Node.js disk compile caching at the very start of the webpack CLI bootstrap in bin/webpack.js, before child processes or webpack-cli loading run.

On Node.js 22.8+, it calls enableCompileCache() from module when that API exists, inside a try/catch so older or restricted environments keep current behavior. A patch changeset records the release note for the webpack package.

^{Reviewed by Cursor Bugbot for commit d057a59. Bugbot is set up for automated code reviews on this repo. Configure here.}

This PR is packaged and the instant preview is available (929b113).

Install it locally:

• npm

npm i -D webpack@https://pkg.pr.new/webpack@929b113

• yarn

yarn add -D webpack@https://pkg.pr.new/webpack@929b113

• pnpm

pnpm add -D webpack@https://pkg.pr.new/webpack@929b113

Types Coverage

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.79%. Comparing base (fbcbe3e) to head (d057a59).
⚠️ Report is 1 commits behind head on main.

@@            Coverage Diff             @@
##             main   #21523      +/-   ##
==========================================
- Coverage   93.79%   93.79%   -0.01%     
==========================================
  Files         620      620              
  Lines       73798    73798              
  Branches    21306    21306              
==========================================
- Hits        69220    69218       -2     
- Misses       4578     4580       +2     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

Merging this PR will degrade performance by 26.27%

❌ 2 regressed benchmarks
✅ 214 untouched benchmarks

Performance Changes

_{Comparing perf/enable-compile-cache (d057a59) with main (fbcbe3e)¹}

@bjohansebas lets make the same in webpack-cli, some developers uses webpack-cli, instead webpack directly

@alexander-akait webpack/webpack-cli#4818