重启Nuxt.js或新建pages目录vue文件时layouts/default.vue被重置如何解决

问题根因 #

该问题通常是Nuxt的自动布局生成功能、第三方模块钩子或自定义开发逻辑触发了 layouts 目录的文件写入导致的，可通过以下步骤逐步排查修复： #

修复步骤 #

1. 调整Nuxt核心配置 #

打开项目根目录下的nuxt.config.ts（或nuxt.config.js），新增/修改以下配置项：

export default defineNuxtConfig({
  // 显式启用自定义布局，禁用自动生成逻辑
  layouts: true,
  // 关闭实验性自动布局生成特性
  experimental: {
    autoLayouts: false
  }
})

配置修改完成后，先删除项目根目录下的.nuxt缓存文件夹，再重启开发服务验证。

2. 排查第三方模块与自定义逻辑 #

如果调整配置后问题仍存在，按以下顺序排查：

• 逐个禁用nuxt.config中引入的第三方Nuxt模块，部分脚手架、低代码类模块会自带文件自动生成逻辑，确认触发覆盖的模块后将其移除或关闭对应配置即可
• 检查项目内modules、server/plugins目录下的自定义代码，是否存在监听pages目录变更、自动写入layouts/default.vue的钩子逻辑，删除对应写入代码即可

3. 校验文件路径规范 #

确保你的自定义布局文件满足以下要求：

• 存放在项目根目录的layouts文件夹下，而非.nuxt、node_modules等自动生成目录内的layouts路径
• 文件名为全小写的default.vue，大小写完全匹配，Nuxt对布局文件名大小写敏感

内容的提问来源于stack exchange，提问作者trevorchiu