You need to enable JavaScript to run this app. React项目CSS引用public目录图片无法解析报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

React项目CSS引用public目录图片无法解析报错如何解决

报错原因

你当前使用的相对路径写法会触发css-loader的路径解析逻辑,会从当前CSS文件所在的src/styles目录下查找./assets/subtract.png,而你的图片存放在public目录下,自然会提示找不到资源。
另外React项目中public目录下的静态资源不会被构建工具的loader处理,会直接挂载到站点的根服务路径下,不能用相对路径从src目录的CSS文件中引用。

解决方案

方案1:将图片移入src目录(更推荐)

这种方式下图片会被webpack自动处理,支持压缩、哈希缓存戳等优化,上线后不会出现静态资源缓存问题:

  • 先在src目录下新建assets文件夹,把subtract.png放到该文件夹内
  • 修改CSS中的路径为相对当前CSS文件的路径即可:
body {
  background-image: url("../assets/subtract.png");
}

方案2:直接引用public目录资源

如果必须要把图片存放在public目录下,直接使用根路径写法即可:

  • 图片放在public/assets/下的写法:
body {
  background-image: url("/assets/subtract.png");
}
  • 图片直接放在public根目录下的写法:
body {
  background-image: url("/subtract.png");
}

注意:如果你的项目不是部署在域名根路径(比如部署在https://domain.com/sub-path/下),需要把路径改成url("%PUBLIC_URL%/assets/subtract.png"),构建时会自动替换为你配置的项目根路径。

内容的提问来源于stack exchange,提问作者issac15x

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 08:12:00