my-first-ai-web_问题记录01:Next.js的App Router架构下的布局(Layout)使用

在使用 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 布局机制的理解上:

  1. 自动应用特性 :在 App Router 架构中,layout.tsx自动应用 于同一目录下的所有 page.tsx,无需显式导入。

  2. 嵌套效果 :当我在 page.tsx 中再次导入并使用 Layout 组件时,实际上创建了布局的嵌套:

    • 外层:Next.js 自动应用的布局
    • 内层:页面中显式使用的布局
    • 这种嵌套导致了三分屏的视觉效果
  3. 与传统路由的区别 :这与旧版 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 会自动应用于该目录所有页面
  • 布局会形成嵌套关系(子布局继承父布局)
  • 无需在页面中显式导入和使用布局组件
相关推荐
读忆8 分钟前
在前端开发中使用组件后, 若是出了bug, 应该如何排查, 怎么排查, 解决方式是什么?
前端·javascript·vue.js·bug
Aevget10 分钟前
界面控件DevExpress JS & ASP.NET Core v25.2新版亮点 - AI驱动扩展功能升级
javascript·asp.net·界面控件·devexpress·ui开发
We་ct13 分钟前
LeetCode 162. 寻找峰值:二分高效求解
前端·算法·leetcode·typescript·二分·暴力
HWL567915 分钟前
uni-app的生命周期
前端·vue.js·uni-app
softbangong16 分钟前
829-批量提取各子文件夹下文件到一级目录
java·服务器·前端·自动化工具·批量文件处理·文件提取工具·文件夹整理
李剑一17 分钟前
别再瞎写 Cesium 可视化!热力图 + 四色图源码全公开,项目直接复用!
前端·vue.js·cesium
SuperEugene19 分钟前
Vue3 + Vue Router + Pinia 路由守卫规范:beforeEach 应做 / 不应做,避死循环、防重复请求|状态管理与路由规范篇
开发语言·前端·javascript·vue.js·前端框架
Greg_Zhong20 分钟前
Css知识之伪类和伪元素
前端·css
Mintopia21 分钟前
GPT-5.3-Codex 底层逻辑是什么,为什么编码强?
前端·人工智能·ai编程
Mintopia23 分钟前
Opus 模型凭什么收费贵,与其他模型对比理由是什么?
前端·人工智能