如何在 React 中正确渲染 API 返回的全部博客文章(而非仅首条)

本文讲解如何修改 react 组件,将从后端 api 获取的多条博客数据完整渲染到页面,解决因误用数组索引(如 `data[0]`)导致只显示单篇文章的问题,并提供可复用的列表渲染与结构优化方案。

在您提供的代码中,核心问题在于:虽然 API 返回的是一个包含多个博客对象的数组(例如 post?.datas?.data),但组件中始终只取 post?.datas?.data[0] 渲染标题、内容等字段

,且外层 JSX 结构被硬编码为单个

容器——这导致无论 API 实际返回多少条数据,界面都仅展示第一条。

要正确展示所有博客文章,关键步骤如下:

✅ 1. 确认数据结构并安全访问

首先通过 console.log(post) 明确 API 响应格式。典型结构应为:

{
  "datas": {
    "data": [
      { "id": 1, "title": "Post One", "content": "...", "attachment": { "media_url": "/uploads/1.jpg" } },
      { "id": 2, "title": "Post Two", "content": "...", "attachment": { "media_url": "/uploads/2.jpg" } }
    ]
  }
}

因此,应使用 post?.datas?.data || [] 作为真实数据源,并确保其为数组类型。

✅ 2. 使用 .map() 遍历渲染每一篇文章

避免手动 push 或固定索引,改用数组映射动态生成列表项。每个元素需带唯一 key(推荐使用 item.id):

function Posts() {
  const { data: post, loading, error } = useFetch("https://accounts.com/api/blogs");

  if (loading) return 

Loading...

; if (error) { console.error("API Error:", error); return

Failed to load posts.

; } // ✅ 安全提取博客数组 const blogList = post?.datas?.data || []; // ✅ 使用 map 渲染全部文章 const showData = blogList.map((item) => ( @@##@@
{item.title}
?️ {item.views || 0}

{item.content?.substring(0, 120)}...

{new Date(item.created_at).toLocaleDateString()} )); return ( {showData.length > 0 ? showData :

No posts available.

} ); } export default Posts;

⚠️ 注意事项与最佳实践

  • key 必不可少:React 列表渲染必须为每个子元素指定稳定唯一的 key,否则可能引发更新异常或性能问题。
  • 图片路径校验:item.attachment?.media_url 可能为 null/undefined,建议添加 fallback 或条件渲染(如 item.attachment?.media_url && (...))。
  • 响应式布局:.row.g-4 + .col-4 在 Bootstrap 5 中支持自动换行,适配多列网格;如需适配移动端,可叠加 .col-md-4 .col-sm-6 .col-12。
  • 错误防御:对 item.title、item.content 等字段做可选链(?.)和空值判断,防止运行时崩溃。
  • 分页扩展提示:当前逻辑适用于“第 1 页全部数据”。若后续需服务端分页(如 /api/blogs?page=1&limit=10),只需在 useFetch 中动态传入参数即可,前端渲染逻辑无需改动。

通过以上重构,您的博客页面将真正实现「一次请求、全量展示」,为后续集成无限滚动或 Pagination 组件打下坚实基础。