0

0

React 中自定义组件返回 JSX 数组时正确设置 key 的完整指南

霞舞

霞舞

发布时间:2026-01-06 16:38:02

|

681人浏览过

|

来源于php中文网

原创

React 中自定义组件返回 JSX 数组时正确设置 key 的完整指南

react 中使用 map 渲染列表时,必须为每个直接子元素(而非其内部元素)提供唯一且稳定的 key 属性;若返回 fragment 或混合节点,key 应作用于最外层容器组件。

你遇到的警告 Each child in a list should have a unique 'key' prop 并非因为没写 key,而是因为 key 没有被放在 React 列表渲染的直系子节点上

在你的原始代码中:

words.map((word, index) => {
  if (index !== words.length - 1) {
    return <>{word} // ;
  } else {
    return {word};
  }
})

问题在于:> 是 React.Fragment 的简写,但它本身不可接收 key 属性(空 Fragment 不支持 props)。你把 key={word} 错误地加在了 上,而该 并非 map 返回数组的顶层元素——真正作为 map 结果项的顶层节点是 Fragment。React 要求 key 必须由 map 返回的每个顶层 JSX 元素自身携带,而不是其子元素。

✅ 正确做法:将 key 显式赋予 React.Fragment(或其简写 > 的替代方案——带 key 的 ):

import React from 'react';

function StyleWords({ words, ...props }) {
  return words.map((word, index) => {
    if (index !== words.length - 1) {
      // ✅ key 必须加在 Fragment 上(不能加在 span 上)
      return (
        
          {word} // 
        
      );
    } else {
      // ✅ 最后一项直接返回带 key 的 span(它本身就是顶层节点)
      return {word};
    }
  });
}

⚠️ 注意事项:

  • 不要用 word 单独作 key:如果数组中存在重复单词(如 ['hello', 'world', 'hello']),key={word} 将导致 key 冲突,触发 React 警告甚至渲染异常。推荐组合索引:key={${word}-${index}}(适用于无动态增删场景);更健壮的方式是确保数据含唯一 ID,或使用 useId(React 18+)生成稳定标识。
  • Fragment 必须显式使用 React.Fragment 或 :空标签 ...> 不支持 key,这是常见误区。
  • 避免在条件分支中混用不同根节点类型:本例中前几项返回 Fragment、最后一项返回 span,虽可行,但可优化为统一结构,提升可维护性:
// ✅ 更清晰统一的写法(推荐)
function StyleWords({ words, separator = ' // ' }) {
  return words.map((word, index) => (
    
      {word}
      {index < words.length - 1 && {separator}}
    
  ));
}

这样既保证 key 正确绑定,又语义清晰、易于扩展分隔符逻辑。记住核心原则:key 属于列表项的容器,不是内容元素

相关专题

更多
golang map内存释放
golang map内存释放

本专题整合了golang map内存相关教程,阅读专题下面的文章了解更多相关内容。

73

2025.09.05

golang map相关教程
golang map相关教程

本专题整合了golang map相关教程,阅读专题下面的文章了解更多详细内容。

27

2025.11.16

golang map原理
golang map原理

本专题整合了golang map相关内容,阅读专题下面的文章了解更多详细内容。

57

2025.11.17

java判断map相关教程
java判断map相关教程

本专题整合了java判断map相关教程,阅读专题下面的文章了解更多详细内容。

34

2025.11.27

word背景色怎么改成白色
word背景色怎么改成白色

Word是微软公司的一个文字处理器软件。word为用户提供了专业而优雅的文档工具,帮助用户节省时间并得到优雅美观的结果。word提供了许多易于使用的文档创建工具,同时也提供了丰富的功能供创建复杂的文档使用。怎么word背景色怎么该呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3690

2023.07.21

word最后一页空白页怎么删除
word最后一页空白页怎么删除

word最后一页空白页删除方法有:通过删除回车符、调整页边距、删除分节符或调整分页符位置,您可以轻松去除最后一页的空白页。根据您实际的文档情况,选择适合您的方法进行操作,使您的文档更加美观和整洁。本专题为大家提供word最后一页空白页怎么删除不了相关的各种文章、以及下载和课程。

316

2023.07.24

word最后一页空白页怎么删除不了
word最后一页空白页怎么删除不了

word删除最后一页空白页,可以尝试使用Backspace键删除空白页,如果无效,查找和删除分页符,或者调整页面边距和行距。还可以尝试将文档保存为其他格式并重新打开和保存。本专题为大家提供word最后一页空白页为啥删除不了的相关的文章、下载、课程内容,供大家免费下载体验。

367

2023.07.25

word单页改变纸张方向
word单页改变纸张方向

word单页改变纸张方向:1、在界面上选择文档纸张方向;2、自定义页面设置;3、分节功能。本专题为大家提供word单页改变纸张方向的相关的文章、下载、课程内容,供大家免费下载体验。

617

2023.07.27

java学习网站推荐汇总
java学习网站推荐汇总

本专题整合了java学习网站相关内容,阅读专题下面的文章了解更多详细内容。

6

2026.01.08

热门下载

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

精品课程

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

共58课时 | 3.4万人学习

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

共12课时 | 0.9万人学习

React核心原理新老生命周期精讲
React核心原理新老生命周期精讲

共12课时 | 1万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号