本文介绍如何在 laravel mix 的 webpack.mix.js 中读取项目根目录下的 module_statuses.json 文件，并根据其中布尔值动态决定是否编译指定模块的 js 资源，实现灵活、可配置的前端构建流程。
在 Laravel 项目中，随着模块化程度提高，往往需要按需启用或禁用某些功能模块的前端资源编译（如独立模块的 JS 文件）。Laravel Mix 本身不提供内置的条件编译语法，但借助 Node.js 原生能力，我们可轻松实现「配置驱动」的条件加载逻辑。
核心思路是：将模块开关状态以 JSON 格式（如 module_statuses.json）声明在项目根目录，然后在 webpack.mix.js 中通过 require() 直接加载该 JSON 文件（Node.js 支持 .json 后缀的模块导入），再结合 if 判断动态调用 Mix API。
✅ 正确做法如下（注意路径与结构规范）：
const mix = require('laravel-mix');
const tailwindcss = require('tailwindcss');
// ✅ 直接 require JSON 文件（Node.js 自动解析为对象）
const status = require('./module_statuses.json'); // 推荐显式写 .json 后缀，增强可读性
require('laravel-mix-merge-manifest');
mix.options({
terser: {
extractComments: false,
}
});
mix.js('resources/js/app.js', 'public/js')
.vue();
// ? 条件编译：仅当 module_statuses.json 中对应字段为 true 时才加入编译流程
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 未启用，故不执行任何操作 —— 完全由 JSON 控制
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();? 关键注意事项：
- JSON 文件必须符合标准语法（双引号键名、无尾逗号、UTF-8 编码），否则 require() 会抛出 SyntaxError；
- require('./module_statuses.json') 路径基于 webpack.mix.js 所在位置（即项目根目录），确保文件存在且可读；
- 模块路径（如 'Modules/Module1/...'）需真实存在，否则 Mix 构建时会报 Entry not found 错误（建议配合 fs.existsSync() 进一步校验，生产环境可选）；
- 若模块 JS 文件依赖 Vue 或其他全局变量，请确保其 mix.vue() 或 mix.webpackConfig() 配置与主应用一致，避免运行时异常；
- 修改 module_statuses.json 后，需重新运行 npm run dev / npm run prod 生效（Laravel Mix 不监听 JSON 文件变更）。
? 进阶提示：你还可以封装为复用函数，支持批量处理多个模块：
Object.entries(status).forEach(([module, enabled]) => {
if (enabled && module.startsWith('Module')) {
const moduleName = module.replace('Module', '').toLowerCase();
const srcPath = `Modules/${module}/src/Resources/assets/js/${moduleName}.js`;
if (require('fs').existsSync(srcPath)) {
mix.js(srcPath, 'public/js');
}
}
});通过这种声明式 + 条件式组合，你既能保持构建配置的清晰性，又能实现运维友好的模块开关管理，为多租户、SaaS 化或灰度发布场景提供坚实基础。
