You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Nuxt3中layouts目录下的default.vue不生效问题求助

Nuxt中Default Layout未生效排查方案

问题代码

<template>
    <div>
        <p>123</p>
        <slot/>
    </div>
</template>
<style scoped>
    .router-link-exact-active{
        color:red;
    }
</style>

排查要点

  • 确认布局文件的位置与命名:确保default.vue存放在项目根目录的layouts文件夹下,文件名严格小写(Linux/macOS系统区分大小写,命名错误会导致Nuxt无法识别)。
  • 检查页面组件的布局配置:页面组件默认使用default布局,但如果手动设置了layout: false或其他布局名称,会跳过默认布局。可在页面组件中显式指定布局测试:
    export default {
      layout: 'default'
    }
    
  • 验证Nuxt配置的布局路径:若自定义过布局目录,需在nuxt.config.js中确认dir.layouts配置是否与实际文件夹路径一致:
    export default {
      dir: {
        layouts: 'your-custom-layout-dir'
      }
    }
    
  • 排查插槽与页面内容的兼容性:布局中的<slot/>是页面内容的入口,可在页面中添加简单测试文本(如<h1>页面测试内容</h1>),确认是否是页面组件本身的问题导致布局未渲染。
  • 清除缓存并重启项目:Nuxt的缓存可能导致布局更新不生效,删除.nuxt文件夹和node_modules/.cache目录后,重新执行npm run dev。
  • 临时移除样式作用域测试:虽然scoped样式一般不影响布局渲染,但可暂时移除scoped属性,排查是否存在样式冲突导致的布局异常。

内容的提问来源于stack exchange,提问作者owp bush

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.19 01:42:50