轮播图问题主因是初始化时机、类型校验和容器约束；swiper-item必须为swiper直接子元素，current须为number类型，indicator-dots需满足高度≥200rpx等条件，跨端需注意属性差异与autoplay恢复逻辑。
轮播图不动、指示点不显示、自动播放停了就不动——这些问题基本都出在初始化时机、类型校验和容器约束上，不是代码写错，而是没踩对 uni-app 的渲染节奏。
swiper-item 必须是 swiper 的直接子元素
嵌套一层 view 或 scroll-view 就会失效，哪怕只包个空 view 也不行。常见错误写法：
<swiper><view><swiper-item>...</swiper-item></view></swiper><swiper><scroll-view><swiper-item>...</swiper-item></scroll-view></swiper>
正确写法必须是：
<swiper><swiper-item><image src="/a.jpg"></image></swiper-item><swiper-item><image src="/b.jpg"></image></swiper-item></swiper>
如果需要加过渡层（比如遮罩文字），用 position: absolute 覆盖在 swiper-item 内部，别动 DOM 层级结构。
current 值必须是 Number 类型
current 属性传字符串（如 "0"）或 null 会导致 swiper 卡死、无法响应滑动。尤其从接口取数据后直接赋值时容易忽略类型转换：
- 从
data初始化时用current: 0，别写current: "0" - 在
@change回调里更新current，务必用Number(e.detail.current)或parseInt() - 异步加载轮播数据时，先初始化
swiperList: []，再setData({ swiperList: res.data })，避免初始swiper-item数量为 0 导致组件未初始化
真机调试时发现“第一次滑不动”，大概率是这个原因。
indicator-dots 不显示的三个硬性条件
指示点不是“开了就一定出现”，它有明确的渲染前提：
-
swiper容器高度必须 ≥200rpx（实测低于此值可能直接不渲染） - 父容器不能设
overflow: hidden，否则指示点被裁掉 - 背景色与指示点默认白色冲突（比如浅灰背景），需显式设置
indicator-color和indicator-active-color
自定义样式能力有限：dotsStyles 只能改颜色、宽高、边框等基础项，不能调位置或加动画；想精细控制（比如右下角带文字），得自己手写 view + flex 模拟。
H5 与 App 端 swiper 行为差异
底层实现不同导致部分属性仅在特定平台生效：
-
vertical：App 端支持上下滚动，H5 端仅支持左右 -
previous-margin/next-margin：App 端可用，H5 端无效 - 鼠标滚轮翻页：H5 端需手动监听
mousewheel事件并调this.$refs.swiper.changeCurrent()，App 端无意义
跨端项目务必把 swiper 高度设为 rpx 单位（如 style="height: 300rpx;"），避免 H5 像素缩放或小程序视口适配异常导致内容截断。
最易被忽略的是：autoplay 在用户手动滑动后会永久暂停，不会自动恢复——这不是 bug，是设计行为。需要“滑完继续播”，必须监听 @change 并在回调里重置逻辑，且要用 this.$nextTick() 确保 DOM 更新完成后再触发。
