CSS中url()路径失效主因是误认基准路径——它始终以CSS文件自身位置为起点，而非HTML；构建后CSS与资源目录层级变化导致相对路径错位，需据实际产物结构调整或改用public/目录、JS导入等方案。
CSS里url()路径失效，90%是因为你误以为它以HTML为基准——其实它只认CSS文件自己在哪。
为什么url("../img/logo.png")在开发时能跑，打包后就404
构建工具（如Webpack、Vite）会把.css抽离到dist/css/，图片却放在dist/img/。此时url("../img/logo.png")实际请求的是dist/css/../img/logo.png → dist/img/logo.png，看似对？但问题常出在：CSS源文件（如src/css/main.css）里写的../img/，是按src/css/算的；而构建后CSS在dist/css/，它“认为”的上一级是dist/，所以../img/才刚好对上。
但如果你源文件在src/components/Button.css，写url("../../assets/logo.png")，构建后CSS被挪到dist/css/，那../../就会退过头，指向dist/../assets/（不存在）。
- 打开浏览器 Network 面板，过滤
img，看 404 请求的真实 URL 是什么 - 进
dist目录，用文件管理器展开，肉眼数清 CSS 文件和目标图片之间的层级差 - 别依赖编辑器路径提示——VS Code 的自动补全可能按源码结构推，不反映构建后结构
Webpack项目中MiniCssExtractPlugin的publicPath怎么设才不翻车
这个配置才是真正决定最终url()在浏览器里“往哪跳”的开关。它不是改源码，而是重写输出CSS里的所有路径。
立即学习“前端免费学习笔记（深入）”；
- 如果构建后CSS地址是
/css/app.css，图片地址是/img/icon.png，那么publicPath应设为"../"（让url("img/icon.png")变成/css/../img/icon.png→/img/icon.png） - 不要同时配
output.publicPath和MiniCssExtractPlugin.publicPath——后者优先级更高，且更精准 - Vue CLI 2 在
build/utils.js里改ExtractTextPlugin.extract()的publicPath；Vue CLI 3+ 或 Vite 不走这条路，得换思路（见下一条） - 确认
css-loader的url选项为true（默认开启），否则url()根本不被解析
Vite / Vue CLI 3+ 项目里，url()路径该写成什么样
这类现代工具链不推荐你在CSS里手写相对路径，因为构建逻辑更复杂，且publicPath不可控。直接走约定优于配置。
- 把图片全放
public/目录下（如public/logo.png），CSS里写url("/logo.png")——public/下资源直接映射到站点根路径，不参与打包，路径稳定 - 如果图在
src/assets/，别在CSS里写url()，改用 JS 导入：import logo from "@/assets/logo.png"，再通过内联样式或 CSS 变量传进去 - 硬要用
url()+ 别名？确保css-loader（Vite 默认不用）或 PostCSS 插件支持，且路径带~@assets/前缀（~是 css-loader 识别别名的关键标记） - 避免
url("@/assets/logo.png")—— 缺~就是纯字符串，不会被解析
最不该忽略的三个基础检查点
很多“路径问题”根本不是写法问题，而是运行环境卡住了。
- 用
file://协议双击打开 HTML？所有url()都会失效——浏览器禁止跨域读取本地文件，必须起本地服务（vite、npx serve、Live Server） - Network 面板里请求 URL 显示
http://localhost:3000/css/../img/logo.png，但服务器没配静态资源路由？那不是路径错，是服务没响应 - 路径没错但返回 403？检查文件权限或 Web 服务器配置（比如 Nginx 没开
autoindex，或 Spring Boot 没把static/目录暴露出来）
路径本身没有对错，只有“在当前构建产物结构 + 当前服务部署路径”下是否成立。盯着 Network 里的 Request URL 看，比反复猜 ../ 有用十倍。
