Skip to content

组件名未大写

快速摘要

你用小写名定义组件 —— React 将 <myComponent> 视为 DOM 元素而非组件,不渲染任何内容。

为什么发生

  • 组件函数或类用小写首字母定义,如 function myComponent() 而非 MyComponent

  • 组件以小写名导入并在 JSX 中用作 <myComponent>

  • 持有组件的变量是小写的,JSX 将标签解释为原生 HTML 元素

最小示例

✗ 错误代码
function greeting({ name }) {
  return <p>Hello, {name}</p>;
}
function App() {
  return <greeting name='World' />; // treated as DOM element
}
✓ 修复代码
function Greeting({ name }) {
  return <p>Hello, {name}</p>;
}
function App() {
  return <Greeting name='World' />; // treated as component
}

大写组件名告诉 React 将其视为组件而非 DOM 元素,从而正确渲染。

如何诊断

  • 检查组件是否在 DOM 检查器中渲染为空或未知 HTML 元素

  • 验证组件函数或类名以大写字母开头

  • 查看控制台中关于小写组件名的未知 DOM 元素的 React 警告

如何修复

  • 将组件重命名以大写字母开头:MyComponent 而非 myComponent

  • 在定义和 JSX 使用中都使用 PascalCase 命名所有组件

  • 如果用变量持有组件,在 JSX 中使用前赋值给大写变量

如何预防

  • 始终用 PascalCase(大写首字母)命名组件以区分 HTML 元素

  • 使用强制 PascalCase 命名 React 组件的代码检查器

相关资源

相关术语

相关课程

← 返回语言