swiper.js 启用 `loop: true` 但无法无缝循环，根本原因在于启用了不兼容的 `cssmode: true`；禁用该选项并确保 html 结构与 swiper v10 规范一致，即可恢复完整循环功能。
在使用 Swiper.js 构建作品集轮播组件时，许多初学者会遇到“滑动到最后一个幻灯片后无法自动跳回开头”的问题——即 loop: true 未生效。这并非配置遗漏，而是由一个关键冲突导致：cssMode: true 与 loop 功能互斥。
根据 Swiper 官方文档，当启用 cssMode: true 时，Swiper 会切换至基于现代 CSS Scroll Snap 的渲染模式。该模式虽性能更优、动画更原生，但明确不支持 loop、virtual、effect（如 fade/cube）等高级特性。因此，只要保留 cssMode: true，无论是否设置 loop: true，循环逻辑都会被静默忽略。
✅ 正确做法是：彻底移除 cssMode: true 配置项，并确保其他基础条件满足：
1. 检查 Swiper 初始化配置（修正版）
let swiperPortfolio = new Swiper('.portfolio__container', {
// ❌ 删除这一行 → cssMode: true,
loop: true, // ✅ 保持启用
navigation: {
nextEl: '.swiper-button-next',
prevEl: '.swiper-button-prev',
},
pagination: {
el: '.swiper-pagination',
clickable: true,
},
autoplay: {
delay: 5000,
disableOnInteraction: false // 推荐添加：用户操作后继续自动播放
},
mousewheel: true,
keyboard: true,
// ⚠️ 注意：不要重复声明 autoplay: true（已包含在 autoplay 对象中）
});2. 确保 HTML 结构符合 Swiper v10 规范
- 使用 class="swiper" 替代旧版 class="swiper-container"（v10+ 推荐写法）
- 必须包含 swiper-wrapper 和至少 3 个 swiper-slide 元素（Swiper loop 模式要求最少 3 张幻灯片才能生成克隆节点）
- 添加 Swiper 样式表（常被遗漏！）
3. 补充建议（提升稳定性）
- 避免自定义覆盖 Swiper 内部样式：例如 .swiper-button-prev::after { content: ''; } 会清除 Swiper 默认箭头图标，应改用 navigation.nextEl/prevEl 指向带图标的容器，或通过 CSS 覆盖图标字体。
- 检查控制台报错：若仍不循环，请打开浏览器开发者工具 → Console，确认是否出现 Swiper: Loop mode requires at least 3 slides 类似警告（说明幻灯片数量不足）。
- 调试技巧：临时添加 on: { slideChange: () => console.log('slide:', swiper.realIndex) }，观察 realIndex 是否在循环中正确跳变（如 0→1→2→0）。
? 总结：Swiper 的 loop 是一个依赖 DOM 克隆机制的功能，而 cssMode 绕过了 Swiper 的 JS 渲染层，直接交由浏览器 Scroll Snap 处理，二者底层逻辑不可共存。作为初学者，优先使用默认渲染模式（即不设 cssMode），待项目稳定后再评估是否需启用 cssMode 并放弃循环等高级交互。
现在你的作品集轮播将真正实现无缝、无限循环——从最后一张平滑过渡到第一张，专业感立现。
