本文介绍如何在 laravel mix 的 `webpack.mix.js` 文件中，根据项目根目录下的 `module_statuses.json` 文件动态启用或禁用模块资源的编译，实现灵活、可配置的前端构建流程。
在 Laravel 项目中，随着模块化程度提高，常需按需编译不同模块的 JS/CSS 资源。Laravel Mix 本身不提供原生的“条件编译”语法，但可通过 Node.js 原生能力（如 require() 加载本地 JSON）结合 JavaScript 逻辑轻松实现。
✅ 正确做法：动态加载 JSON 并条件调用 Mix API
首先，确保你的 JSON 配置文件 module_statuses.json 位于项目根目录（与 webpack.mix.js 同级），内容如下：
{
"Module1": true,
"Module2": true,
"Module3": false
}⚠️ 注意：Node.js 的 require() 默认支持 .json 扩展名，但要求文件名不含下划线前缀（如 module_statuses.json 可直接 require('./module_statuses')；若命名为 _module_statuses.json 则需用 fs.readFileSync + JSON.parse）。
接着，在 webpack.mix.js 中按以下方式改写：
const mix = require('laravel-mix');
const tailwindcss = require('tailwindcss');
const status = require('./module_statuses'); // 自动解析 JSON，返回普通对象
require('laravel-mix-merge-manifest');
mix.options({
terser: {
extractComments: false,
}
});
mix.js('resources/js/app.js', 'public/js')
.vue();
// ✅ 条件编译：仅当对应模块启用时才加入构建流程
if (status.Module1) {
mix.js('Modules/Module1/src/Resources/assets/js/module1.js', 'public/js');
}
if (status.Module2) {
mix.js('Modules/Module2/src/Resources/assets/js/module2.js', 'public/js');
}
// 可扩展：支持 Module3 或其他任意键（推荐使用 hasOwnProperty 安全校验）
if (status.hasOwnProperty('Module3') && status.Module3) {
mix.js('Modules/Module3/src/Resources/assets/js/module3.js', 'public/js');
}
mix.extract()
.sass('resources/sass/app.scss', 'public/css')
.copy('node_modules/@fortawesome/fontawesome-free/webfonts', 'public/webfonts')
.options({
processCssUrls: false,
postCss: [tailwindcss('./tailwind.config.js')],
})
.version();? 关键细节说明
- 路径一致性：require('./module_statuses') 中的 ./ 表示相对于当前 webpack.mix.js 文件的位置，确保 JSON 文件存在且可读。
- 类型安全：JSON 中的布尔值会被正确解析为 true/false，无需额外转换；访问不存在的属性会返回 undefined，因此建议用 hasOwnProperty 或可选链（?.）增强健壮性（Node ≥14 支持）。
- 构建隔离性：被跳过的 .js() 调用不会生成输出文件，也不会触发相关依赖解析，真正实现“零编译开销”。
- 热更新兼容：Laravel Mix 在 watch 模式下会监听 webpack.mix.js 变更，但不会自动监听 module_statuses.json。如需实时响应 JSON 修改，可借助 mix.webpackConfig({ watchOptions: { ... } }) 手动添加监听，或配合 nodemon 重启 Mix 进程（生产环境不推荐）。
✅ 最佳实践建议
- 将 module_statuses.json 加入 .gitignore（若含环境敏感配置），或拆分为 module_statuses.default.json + 环境覆盖；
- 在 CI/CD 流程中，可通过 echo '{...}' > module_statuses.json 动态生成配置；
- 对复杂场景（如多环境、嵌套模块），可升级为 config/*.js 模块化配置，利用 export default 提供更丰富的逻辑能力。
通过这一模式，你既能保持 webpack.mix.js 的简洁可维护性，又能赋予前端构建以业务语义——让配置驱动编译，而非硬编码决定一切。
