讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

如何在 React(TypeScript)项目中正确渲染静态图片资源

落芳君_1590

落芳君_1590

发布时间:2026-11-21 09:57:39

|

153人浏览过

|

来源于php中文网

原创

本文详解在 React + TypeScript 项目中无法渲染 public/images/ 下图片的根本原因及解决方案,重点说明:必须显式使用 标签并传入合法 src,而非仅传递路径字符串。

本文详解在 react + typescript 项目中无法渲染 `public/images/` 下图片的根本原因及解决方案,重点说明:必须显式使用 `如何在 React(TypeScript)项目中正确渲染静态图片资源` 标签并传入合法 `src`,而非仅传递路径字符串。

在你的国际象棋棋盘项目中,图片未渲染并非路径错误或组件逻辑问题,而是语义缺失——你将图片路径(如 "/images/black_pawn.png")作为 prop 传入了 Tile 组件,但 Tile 组件内部并未创建任何 HTML 图像元素来消费该路径。React 不会自动将字符串“变成图片”,它只负责渲染你明确返回的 JSX 结构。

✅ 正确做法:在 Tile 组件中主动渲染 <img alt="如何在 React(TypeScript)项目中正确渲染静态图片资源" > 元素

你需要修改 Tile.tsx,使其在接收到 image 路径时,动态插入 <img alt="如何在 React(TypeScript)项目中正确渲染静态图片资源" > 标签,并添加基础容错处理(例如路径为空时不渲染图片):

Drizzle ORM TypeScript SQL 数据库工具包
Drizzle ORM TypeScript SQL 数据库工具包

Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。

下载
// src/Tiles/tile.tsx
import './tile.css';

interface Props {
  image?: string;
  number: number;
}

export default function Tile({ image, number }: Props) {
  const isDark = number % 2 === 0;

  return (
    <div className={`tile ${isDark ? 'black-tile' : 'white-tile'}`}>
      {image && (
        <img
          src={image}
          alt={`Chess piece on tile ${number}`}
          className="piece-image"
          // 可选:防止拖拽时被选中
          draggable={false}
        />
      )}
    </div>
  );
}

同时,建议为图片添加简单样式以确保尺寸可控(例如在 tile.css 中):

/* src/Tiles/tile.css */
.piece-image {
  width: 80%;
  height: 80%;
  object-fit: contain;
  pointer-events: none; /* 避免干扰棋子交互逻辑 */
}

⚠️ 注意事项与最佳实践

  • 路径必须以 / 开头:你已正确使用 "/images/black_pawn.png" —— 这是相对于 public/ 目录的绝对路径,在生产构建后仍有效(✅ 推荐)。
  • ❌ 不要使用 require() 或 import 图片:public/ 下资源应直接用字符串路径引用;若图片放在 src/ 下才需 import imgPath from './images/black_pawn.png'。
  • 始终添加 alt 属性:提升可访问性,且当图片加载失败时显示提示文本。
  • 检查浏览器控制台:若仍不显示,请打开 DevTools → Network 标签页,过滤 .png,确认请求是否返回 404(路径拼写错误、大小写不符、文件未放入 public/images/)。
  • 避免内联样式硬编码宽高:后续可结合 CSS Grid 或 Flex 布局统一控制棋格与棋子比例。

✅ 验证步骤(快速排查)

  1. 在浏览器中直接访问 http://localhost:3000/images/black_pawn.png —— 应能正常下载图片;
  2. 查看 Tile 渲染后的 DOM,确认 <img src="..." alt="如何在 React(TypeScript)项目中正确渲染静态图片资源" > 是否存在于对应 <div class="tile"> 内;<li>检查控制台是否有 <code>Failed to load resource 报错。
  3. 只要路径正确、<img alt="如何在 React(TypeScript)项目中正确渲染静态图片资源" > 标签被渲染、且无 CORS 或 MIME 类型问题,图片即可稳定显示。这是前端资源加载最基础也最关键的约定:路径 ≠ 图像,JSX 才是视图的唯一来源。

热门AI工具

更多
函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

7915

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

4332

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

3990

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

3999

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

5399

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

3941

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

3749

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

3208

2023.09.01

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 12.6万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn