播面 如何在 Node.js 中通过 API 调用 Webpack（Compiler API）？
在 Node.js 中通过 API 调用 Webpack（即使用 Compiler API）非常直观。这种方式通常用于自定义构建流程、开发自定义 DevServer、开发 SSR（服务端渲染）框架或集成到其他自动化工具中。
以下是使用 Webpack Node.js API 的完整指南：
1. 基础用法：单次执行构建 (compiler.run)
这是最基础的用法，相当于在命令行运行 npx webpack。
javascript
const webpack = require('webpack');
// 可以引入独立的配置文件，也可以直接编写配置对象
const webpackConfig = require('./webpack.config.js');
// 1. 初始化 Compiler 实例
const compiler = webpack(webpackConfig);
// 2. 调用 run 方法开始构建
compiler.run((err, stats) => {
// 3. 处理 Node.js 级别的致命错误（如配置文件错误、模块丢失等）
if (err) {
console.error(err.stack || err);
if (err.details) {
console.error(err.details);
}
return;
}
// 4. 处理 Webpack 编译过程中的错误（如语法错误、缺少依赖等）
const info = stats.toJson();
if (stats.hasErrors()) {
console.error('编译失败，错误信息如下：');
console.error(info.errors);
}
if (stats.hasWarnings()) {
console.warn('编译警告：');
console.warn(info.warnings);
}
// 5. 打印格式化的构建日志（类似于命令行输出）
console.log(stats.toString({
chunks: false, // 使构建过程更静默输出
colors: true // 在终端打印彩色日志
}));
// 6. 关闭 Compiler（Webpack 5+ 建议显式关闭以释放资源）
compiler.close((closeErr) => {
if (closeErr) {
console.error('关闭 Compiler 时出错：', closeErr);
}
});
});2. 监听模式：增量构建 (compiler.watch)
如果你需要像 webpack --watch 一样，在文件修改时自动重新编译，可以使用 watch 方法。
javascript
const webpack = require('webpack');
const webpackConfig = require('./webpack.config.js');
const compiler = webpack(webpackConfig);
// 配置 watch 选项
const watchOptions = {
aggregateTimeout: 300, // 延迟构建（ms），合并多次修改
poll: undefined // 是否通过轮询的方式监听（默认为 undefined）
};
// 启动监听
const watching = compiler.watch(watchOptions, (err, stats) => {
if (err) {
console.error(err);
return;
}
console.log('重新构建完成！');
console.log(stats.toString({ colors: true }));
});
// 如果需要在某个时刻停止监听：
// watching.close(() => {
// console.log('已停止监听。');
// });3. 核心概念与高级用法
3.1 关键的错误处理机制（注意区分 err 和 stats）
在回调函数中，错误分为两个层级，必须分别处理：
err对象：Node.js 运行时错误（例如配置写错、Webpack 内部 Crash）。stats.hasErrors()：代码编译错误（例如 JS 语法错误、CSS 找不到文件等）。err为null不代表代码没有编译报错！
3.2 拦截生命周期钩子 (Hooks)
你可以直接在代码中通过 compiler.hooks 监听 Webpack 的生命周期事件，无需编写单独的 Plugin 类：
javascript
const compiler = webpack(webpackConfig);
// 在编译完成时触发
compiler.hooks.done.tap('MyNodeScript', (stats) => {
console.log('构建完成，可以执行后续任务（如自动化测试、部署）');
});
// 在开始编译时触发
compiler.hooks.compile.tap('MyNodeScript', () => {
console.log('开始编译...');
});
compiler.run(/* ... */);3.3 输出到内存（不写入磁盘）
如果你在做开发服务器（DevServer）或 SSR，可能希望将编译结果输出到内存（RAM）而不是硬盘，可以使用 memfs 替换默认的文件系统：
javascript
const webpack = require('webpack');
const { createFsFromVolume, Volume } = require('memfs');
const compiler = webpack(webpackConfig);
// 创建内存文件系统并挂载到 compiler
const fs = createFsFromVolume(new Volume());
compiler.outputFileSystem = fs;
compiler.run((err, stats) => {
if (!err && !stats.hasErrors()) {
// 从内存中读取打包后的文件
const content = fs.readFileSync('/path/to/dist/bundle.js', 'utf-8');
console.log(content);
}
});总结
- 单次构建：使用
const compiler = webpack(config)后跟compiler.run()，并在结束后调用compiler.close()。 - 持续监听：使用
compiler.watch()。 - 生命周期扩展：通过
compiler.hooks.<hookName>.tap()注入自定义逻辑。