uni-app 打包不直接使用 webpack，而是通过封装的 uniapp-cli-pack 工具基于 webpack 深度定制；配置须经 vue.config.js 的 configureWebpack 或 chainWebpack 注入，且需适配多端差异。
uni-app 打包用的是 webpack 吗？
不是。uni-app 官方构建工具
（或旧版
）底层确实基于 webpack，但做了深度封装和替换——你无法直接写
并期望它生效。
常见错误现象：
文件存在、配置了
或
，但运行
时完全不生效，甚至没报错。
uni-app 的 webpack 实例由插件在内存中动态生成，不读取项目根目录下的
所有 webpack 相关定制必须通过
的
或
钩子注入
部分平台（如小程序）会二次覆盖配置，比如微信小程序构建会强制重写
和
，硬改可能被忽略
如何在 vue.config.js 中安全修改 webpack 配置？
必须用
（对象/函数）或更推荐的
（链式调用），且需区分平台和构建模式。
使用场景：你想给 H5 端加 CDN 外链，或给 App 端排除某个大体积模块，或调试时启用
。
适合简单合并，例如：
，但注意：H5 和小程序的
值不同，小程序只支持
更精准，可按平台条件操作：
不要在
里直接改
或
，uni-app 已预设好多端路径逻辑，改了会导致资源找不到
为什么改了配置却没生效？常见兼容性陷阱
不是配置写错了，而是 uni-app 构建流程在你之后又覆盖了一次。
典型表现：
显示配置已注入，但最终打包产物没变化，或者 H5 正常、小程序报
。
小程序平台会自动把
中非
兼容的包转成 inline，如果你用
排除某个包，它可能被跳过处理，导致运行时报错
H5 端支持
目录静态资源，但小程序不读该目录；想加全局 JS 脚本，H5 可用
标签，小程序得走
或自定义原生层
uni-app 2.x 和 3.x 的插件版本对
支持程度不同：2.x 中部分 chain 方法（如
）不可用，容易静默失败
替代方案：真需要深度控制，就别绕开 webpack
当
钩子也无法满足（比如要替换整个 loader、接入自定义 plugin、做代码分割策略），说明你已超出 uni-app 抽象层的设计边界。
这时有两个务实选择：
放弃
，改用
+
运行时手动搭，但你要自己维护多端入口、生命周期桥接、样式编译逻辑——成本高，仅适合超大型定制项目
用
做主体，把强依赖 webpack 定制的部分抽成独立 H5 子应用，用
或 iframe 嵌入，保持主流程稳定
最常被忽略的一点：很多所谓“需要 webpack 控制”的需求，其实用
自身机制就能解决——比如按需加载用
动态导入，而非靠
；环境变量用
，而非
真正难的从来不是怎么写配置，而是判断哪部分该交给 uni-app，哪部分该自己扛。
uniapp-cli-pack@dcloudio/vue-cli-plugin-uniwebpack.config.jswebpack.config.jsresolve.aliasexternalsnpm run build:mp-weixinwebpack.config.jsvue.config.jsconfigureWebpackchainWebpackoutput.filenameruntimeChunkconfigureWebpackchainWebpacksource-mapconfigureWebpackmodule.exports = { configureWebpack: { devtool: 'source-map' } }devtoolhidden-source-mapchainWebpackchainWebpack: config => { if (process.env.UNI_PLATFORM === 'mp-weixin') { config.plugin('html').tap(args => { args[0].title = '微信小程序'; return args; }); } }configureWebpackentryoutput.pathconsole.logCannot find module 'xxx'node_modulesuni-appexternalspublicscriptuni.requireNativePluginchainWebpackconfig.module.rule('scss').oneOfsvue.config.jsuniapp-cli-packwebpack@dcloudio/uni-appuni-appweb-viewuni-appimport()SplitChunksPluginprocess.env.UNI_APP_XDefinePlugin