点一棵树,看懂 Nuxt 4「文件放哪里」比「代码怎么写」更重要

左边是约定好的目录树,点任意一个节点(点 ▸/▾ 只折叠不选中),右边告诉你:它干什么、一个真实长什么样的文件、以及「放进这个目录 Nuxt 会自动做什么」。 顶部搜索框能按关键词过滤并自动展开命中项,试试 layouts、api、public、非约定。

Nuxt 4 最大的目录变化:源码收进 app/

Nuxt 3 里在根目录Nuxt 4 移到说明
pages/app/pages/凡是「属于应用运行时代码」的目录,全部收进 app/。根目录只留 server/、public/、content/ 和配置文件,一眼能分清「前端源码 / 后端源码 / 静态资源」。
components/app/components/
composables/app/composables/
utils/app/utils/
layouts/、middleware/、plugins/、app.vueapp/…
error.vueapp/error.vue
srcDir 配置默认 app/(dir.app)Nuxt 3 时代根目录散着放;Nuxt 4 里 dir.app: 'app' 是默认值。

升级提醒:从 Nuxt 3 升上来,要把 pages/ components/ composables/ utils/ layouts/ middleware/ plugins/ app.vue error.vue 整体挪进 app/; 想先不改目录,可以在 nuxt.config.ts 里写 compatibilityDate / future.typescript 相关开关或显式 dir: { app: 'src' } 指定旧位置,但迟早要迁。挪完记得删掉旧的 .nuxt/ 缓存并重跑 npm run dev。

[迷你控制台] 选节点、搜索、展开都会在这里留一行说明