根本原因是模块系统混用:同一文件中同时使用 import(ES Module)和 module.exports(CommonJS),而 Webpack v2+ 禁止该行为;常见于将 Layui 集成到 Vue/React 项目时在 .js 或 .vue 中误写两者,或 Babel 配置未设 "modules": false 导致 export default 被编译为重复的 module.exports。

为什么 layui 项目里突然报 Cannot assign to read only property 'exports' of object
根本原因是模块系统“打架”:你在一个文件里同时用了 import(ES Module)和 module.exports(CommonJS),而 Webpack(尤其是 v2+)默认禁止这种混用。Layui 本身是纯前端、无构建的库,但一旦你把它放进 Vue/React/Webpack 项目中,并在同一个 JS 文件里既 import 其他东西,又写 module.exports = {...},错误就立刻触发。
检查你是不是在 .js 或 .vue 里混写了 import 和 module.exports
这是最常见、最直接的诱因。哪怕只有一行 import axios from 'axios',后面跟着 module.exports = { init: function() {} },Webpack 就会拒绝打包,运行时报错。
- 打开报错定位到的文件,搜索
import和module.exports是否共存 - 注意:
export default和import是兼容的,但module.exports不是 - Vue 单文件组件的
<script></script>块里也适用这条规则,哪怕没显式写import,只要用了import语法引入依赖,就不能再用module.exports - 某些旧版 Layui 扩展写法(比如直接给
window.layui挂方法后又module.exports)也会触发该错误
不是混用?那可能是 Babel 配置漏了 modules: false
Webpack 默认把 ES6 import/export 转成 CommonJS,但如果你的 .babelrc 或 babel.config.js 里没关掉模块转换,Babel 会把 export default 编译成 module.exports =,结果等价于手动写了两次 module.exports —— 第二次赋值就失败。
- 确认你的 Babel 配置中
envpreset 的modules设为false:{"presets": [["@babel/preset-env", {"modules": false}]]} - 如果用的是
babel.config.js,确保它被 Webpack 的babel-loader正确读取(路径、命名、导出格式都对) - Vue CLI 项目默认已设
modules: false,但自建 Webpack 配置容易遗漏这点
服务端渲染(SSR)或 Node 环境下额外踩坑点
在 node 环境跑代码(比如 Nuxt、Vue SSR)时,即使语法没错,也可能因为 Babel 没区分环境导致问题。Node 原生支持 export,但 Webpack 构建时仍按浏览器目标处理,造成冲突。
- 在
babel.config.js中按环境分组配置,例如env.node.presets用{"targets": {"node": "current"}},而env.browser保持{"modules": false} - 避免在 SSR 入口文件或服务端逻辑里直接
require('./xxx.js')一个同时含import和export default的模块 —— Node 会尝试执行它,但 Webpack 已经把它编译成只读exports对象 - Layui 的 DOM 操作代码(如
layui.use)不能在服务端执行,这类代码必须包裹在typeof window !== 'undefined'判断里,否则连初始化都过不去
npm run build 后的生产环境;而且报错堆栈指向打包后的 vendor.xxx.js,实际根源可能藏在某个看似无关的工具函数文件里。务必从报错提示的文件路径倒查,逐行看模块导出写法,而不是只盯着 Layui 引入语句。


















