在使用 Next.js App Router 开发时,我遇到了一个有趣的布局问题:明明在布局中定义了二分屏,页面却显示为三分屏。
问题现象
我定义了一个包含两个可调整面板的布局组件:
jsx
// layout.tsx
import {
ResizableHandle,
ResizablePanel,
ResizablePanelGroup,
} from "@/components/ui/resizable";
export default function Layout({
params,
children,
}: Readonly<{ params: { id: string }; children: React.ReactNode }>) {
const { id = "0" } = params;
return (
<ResizablePanelGroup direction="horizontal" className="min-h-screen">
<ResizablePanel defaultSize={25}>左侧{id}</ResizablePanel>
<ResizableHandle withHandle />
<ResizablePanel defaultSize={75}>{children}</ResizablePanel>
</ResizablePanelGroup>
);
}
然后在页面中显式导入并使用这个布局:
jsx
// page.tsx
import Layout from "./layout";
export default function Page({ params }: { params: { id: string } }) {
const { id = "0" } = params;
return (
<div>
<Layout params={{ id }}>右侧{id}</Layout>
</div>
);
}
结果页面显示为三分屏而非预期的二分屏,布局出现了嵌套重复的问题。
问题根源:Next.js App Router 的布局自动应用机制
经过排查发现,问题出在对 Next.js App Router 布局机制的理解上:
-
自动应用特性 :在 App Router 架构中,
layout.tsx
会自动应用 于同一目录下的所有page.tsx
,无需显式导入。 -
嵌套效果 :当我在
page.tsx
中再次导入并使用Layout
组件时,实际上创建了布局的嵌套:- 外层:Next.js 自动应用的布局
- 内层:页面中显式使用的布局
- 这种嵌套导致了三分屏的视觉效果
-
与传统路由的区别 :这与旧版 Pages Router 中通过
_app.js
手动配置布局的方式截然不同,是 App Router 特有的"文件系统路由"设计。
解决方案
只需移除页面中对布局的显式导入和使用,让 Next.js 自动处理布局应用:
jsx
// 修正后的 page.tsx
export default function Page({ params }: { params: { id: string } }) {
return <div>work page id:{params.id}</div>;
}
此时,页面会自动使用同目录下的 layout.tsx
,并正确显示为二分屏布局。
总结
Next.js App Router 的布局系统带来了更直观的开发体验,但也有其独特的规则:
- 目录下的
layout.tsx
会自动应用于该目录所有页面 - 布局会形成嵌套关系(子布局继承父布局)
- 无需在页面中显式导入和使用布局组件