如何通过Webpack 5正确暴露jQuery?原配置报jQuery未定义错误
Webpack 5 下jQuery全局暴露的兼容实现
原Webpack 4环境下的expose-loader配置在Webpack 5中失效、抛出jQuery is not defined错误,不需要替换其他全局暴露工具,按以下调整即可完全兼容。
核心调整点
- 版本不匹配是这类报错的最高发原因:原先适配Webpack 4的0.x版本expose-loader,基于已废弃的Webpack 4 loader API开发,和Webpack 5的模块解析逻辑完全不兼容。需要卸载低版本包,安装1.0.0及以上版本的expose-loader才能正常运行。
- 修正配置结构:原配置将loader参数直接写在rule根层级的写法,在Webpack 5下会因为规则匹配顺序问题导致参数无法正确传递给loader,需要把expose-loader的配置收敛到
use数组内,修正后的可运行配置如下:
module: { rules: [ { test: require.resolve('jquery'), use: [ { loader: 'expose-loader', options: { exposes: ['$', 'jQuery'] } } ] } ] }
残留问题排查
- 不要对jquery模块开启强制ES Module转换,Webpack 5默认会对CommonJS模块做语法适配,强行转换会导致jquery导出的对象被包裹在default导出中,无法正确挂载到全局作用域。
- 如果项目存在多版本jquery依赖,需要确认
require.resolve('jquery')能覆盖所有被引用的jquery路径,避免第三方插件自带的jquery副本不被expose-loader处理,导致局部场景依然出现变量未定义的报错。 - 配置完成后可直接在浏览器控制台输入
$、jQuery验证全局挂载状态,确认变量正常输出后再加载依赖全局jquery的第三方脚本。
内容的提问来源于stack exchange,提问作者idm
相关产品推荐
相关产品推荐

