Skip to content

组件 Props 类型不匹配

快速摘要

你传递了错误类型的 prop —— 组件期望函数但得到对象,或期望字符串但得到数字。

为什么发生

  • 父组件传递的值类型与组件期望的不同(如字符串而非数字)

  • 可选 prop 未传递且组件未处理 undefined 情况

  • 回调 prop 传递了值而非函数,或相反

最小示例

✗ 错误代码
function Price({ value, currency }) {
  return <span>{value.toFixed(2)} {currency}</span>;
}
// Parent passes string instead of number
<Price value='99.99' currency='USD' /> // value.toFixed is not a function
✓ 修复代码
function Price({ value, currency }) {
  return <span>{Number(value).toFixed(2)} {currency}</span>;
}
<Price value='99.99' currency='USD' /> // converts to number first

在组件内将值转为数字确保 toFixed 始终可用,无论传递的 prop 类型如何。

如何诊断

  • 使用 TypeScript 或 PropTypes 在构建时或运行时捕获类型不匹配

  • 在组件内记录 props 检查运行时的实际类型

  • 查看组件的 prop 文档或类型定义了解期望类型

如何修复

  • 从父组件传递正确类型:用 String()、Number() 转换值或包装为函数

  • 为可选 prop 添加默认值使组件优雅处理 undefined

  • 用 TypeScript 接口或 PropTypes 定义并强制执行期望的 prop 类型

如何预防

  • 用 TypeScript 或 PropTypes 定义 prop 类型并启用严格类型检查

  • 记录期望的 prop 类型并为可选 prop 提供默认值

相关资源

相关术语

相关课程

← 返回语言