You need to enable JavaScript to run this app. Vue CLI项目中使用Swiper不生效且报最大调用栈溢出错误怎么办
优惠活动
大模型
产品
解决方案
定价
更多

Vue CLI项目中使用Swiper不生效且报最大调用栈溢出错误怎么办

Vue CLI 项目中 Swiper 栈溢出报错修复方案
  • 栈溢出的直接诱因是组件自递归
    当前自定义组件把name属性配置为Swiper,同时在组件注册区引入了同名的第三方Swiper组件。Vue解析模板内的<Swiper>标签时,会优先匹配当前组件自身的定义,形成“组件内部无限嵌套渲染自身”的循环,直接撑爆调用栈,触发Maximum call stack size exceeded报错。
    修复方式二选一即可:

    1. 修改当前自定义组件的name值为和Swiper无关的名称,比如CarouselDemo
    2. 引入第三方Swiper组件时通过别名重命名,比如import { Swiper as SwiperContainer, SwiperSlide } from 'swiper/vue',注册时使用别名作为组件名,彻底消除重名问题。
  • 配置属性拼写错误
    代码中编写的space-beetween存在拼写错误,正确的轮播间距配置属性是space-between,拼写错误会导致间距配置完全不生效。

  • 遗漏必备样式引入
    swiper/vue导出的组件不会自动加载内置样式,必须手动引入Swiper核心样式,否则即使组件正常挂载,也会出现布局错位、无法滑动的问题。需要引入的基础样式路径为swiper/css,如果用到分页、导航、滚动条等扩展模块,还需要单独引入对应模块的样式文件。

修复后的可运行代码示例

<template>
    <div>
        <SwiperContainer :slides-per-view="4" :space-between="50">
            <SwiperSlide>SLIDE 1</SwiperSlide>
            <SwiperSlide>SLIDE 2</SwiperSlide>
            <SwiperSlide>SLIDE 3</SwiperSlide>
            <SwiperSlide>SLIDE 4</SwiperSlide>
        </SwiperContainer>
    </div>
</template>
<script>
    // 引入时使用别名避免组件重名
    import { Swiper as SwiperContainer, SwiperSlide } from 'swiper/vue';
    // 引入核心样式
    import 'swiper/css';
    export default{
        name: 'CarouselDemo',
        components: {
            SwiperContainer,
            SwiperSlide
        }
    }
</script>

内容的提问来源于stack exchange,提问作者simon blanco

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.28 13:06:05