Vue项目打包后background-image路径失效的典型现象是CSS中生成的图片URL（如url(7a2b1c8e.png)）未正确相对CSS文件位置，导致浏览器请求路径错误而404；根本原因是url-loader或MiniCssExtractPlugin的publicPath未按CSS输出目录层级配置，应设为'../images/'或'../'以匹配实际资源位置。
打包后 background-image 路径失效的典型现象
Vue + Webpack 项目执行 npm run build 后，dist 目录下 CSS 文件里出现类似 background-image: url(7a2b1c8e.png) 这样的路径，但图片实际在 dist/images/7a2b1c8e.png，导致 404。这不是图片没打包，而是引用路径“跳错了层级”。
css-loader + url-loader 的 publicPath 必须匹配 CSS 文件位置
关键不是改 output.publicPath，而是让 url-loader（或 file-loader）生成的 URL 相对于最终 CSS 文件所在目录有效。比如：
- CSS 最终输出到
dist/css/app.abc.css - 图片输出到
dist/images/icon.png - 那么 CSS 里必须写成
url(../images/icon.png)，即向上一级再进images
所以 loader 配置中要显式指定 publicPath：
{
test: /\.(png|jpe?g|gif|webp)$/,
use: [{
loader: 'url-loader',
options: {
limit: 4096,
name: 'images/[name].[contenthash:8].[ext]',
outputPath: 'images/',
publicPath: '../images/' // ← 注意：这是相对于 CSS 文件路径的
}
}]
}
使用 MiniCssExtractPlugin 时，loader 的 options 不能丢
如果用了 MiniCssExtractPlugin.loader 提取 CSS，它本身不处理图片路径，只负责把 CSS 写入文件。真正决定 url() 里填什么的是后续的 url-loader 或 file-loader。常见错误是只配了 MiniCssExtractPlugin.loader，却忘了给它传 options：
立即学习“前端免费学习笔记（深入）”；
- ❌ 错误写法：
use: [MiniCssExtractPlugin.loader, 'css-loader', 'url-loader'] - ✅ 正确写法：
use: [{ loader: MiniCssExtractPlugin.loader, options: { publicPath: '../' } }, 'css-loader', 'url-loader']
这里的 publicPath: '../' 是告诉 MiniCssExtractPlugin.loader：CSS 文件在 css/ 目录下，所有相对路径都应从该目录出发向上找资源。
静态资源放 assets 还是 static？路径写法完全不同
Vue CLI 默认把 assets 下的图片交给 webpack 处理（走 url-loader），而 static 下的文件直接复制过去（不加 hash，不改名）。两者的引用方式差异很大：
- 用
assets/img/logo.png→ 必须写相对路径如url(../../assets/img/logo.png)，且依赖 loader 配置 - 用
static/img/logo.png→ 可直接写绝对路径url(/img/logo.png)，但部署时必须确保服务器根路径正确
更稳妥的做法是统一走 assets + url-loader，避免手动维护路径；若选 static，就得同步改 vue.config.js 中的 publicPath，否则上线后路径仍会断。
最易被忽略的点：publicPath 是「运行时浏览器解析 URL 时的基准」，不是构建时文件系统的路径。哪怕你本地能跑通，只要部署子目录（比如 https://example.com/myapp/），就一定得检查这个值是否为 './' 或 'myapp/'，而不是默认的 '/'。
