组件名未大写
快速摘要
你用小写名定义组件 —— 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 组件的代码检查器