左边是约定好的目录树,点任意一个节点(点 ▸/▾ 只折叠不选中),右边告诉你:它干什么、一个真实长什么样的文件、以及「放进这个目录 Nuxt 会自动做什么」。
顶部搜索框能按关键词过滤并自动展开命中项,试试 layouts、api、public、非约定。
| Nuxt 3 里在根目录 | Nuxt 4 移到 | 说明 |
|---|---|---|
pages/ | app/pages/ | 凡是「属于应用运行时代码」的目录,全部收进 app/。根目录只留 server/、public/、content/ 和配置文件,一眼能分清「前端源码 / 后端源码 / 静态资源」。 |
components/ | app/components/ | |
composables/ | app/composables/ | |
utils/ | app/utils/ | |
layouts/、middleware/、plugins/、app.vue | app/… | |
error.vue | app/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。