You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用create-react-app的React项目导入PNG图片报未知文件扩展名错误

解决React项目导入PNG图片出现ERR_UNKNOWN_FILE_EXTENSION错误

以下是针对该问题的排查与解决步骤:

  • 检查项目配置是否被修改
    create-react-app默认自带图片资源处理能力,如果你手动执行过eject命令,或是用react-app-rewired等工具修改过webpack配置,可能误删了图片处理规则。若是eject后的项目,打开webpack.config.js,确认module.rules中存在处理图片的规则:
{
  test: /\.(png|jpe?g|gif|svg)$/i,
  type: 'asset/resource',
}

未执行eject的话,尽量不要修改默认配置,避免破坏官方的资源处理逻辑。

  • 验证文件路径与命名
    确认./imgs/xxx.png的路径完全正确,注意系统大小写(Linux/macOS区分大小写,Windows不区分),检查imgs文件夹是否在当前.js文件的同级目录,文件扩展名确实是.png而非.PNG或其他拼写错误。

  • 升级Node.js版本
    部分旧版Node.js对ES模块导入图片的兼容性存在问题,建议升级到项目package.json中engines字段推荐的版本(通常为16.x及以上)。

  • 重启开发服务器
    缓存可能引发异常问题,关闭当前的开发服务器,重新执行npm start或yarn start后再测试导入是否正常。

  • 重装项目依赖
    删除node_modules文件夹和package-lock.json(或yarn.lock),然后执行npm install或yarn install,确保所有依赖包完整安装,没有缺失资源处理相关的依赖。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.24 20:02:05