uni.previewimage 的 urls 必须为数组，current 推荐传数字索引；需过滤无效图片、校验 url、避免本地临时路径直传；loop 和 indicator 各端表现不一，建议禁用或自定义实现。

uni.previewImage 传参必须用数组，current 不能只传单图 URL

很多人以为点哪张图就只传那张图的 URL 进去，结果预览器只显示一张、无法滑动——这是因为 uni.previewImage 的 urls 是强制要求的参数，哪怕你只想预览一张，也得包成数组；current 只是定位索引或匹配项，不是“仅展示这张”的开关。

• current 推荐传数字索引（如 0），比传 URL 更稳定，尤其在 urls 里有重复链接或含查询参数时容易匹配失败
• 如果传字符串 URL 做 current，它会遍历 urls 数组做 === 匹配，大小写、末尾斜杠、query 参数差异都会导致定位失败
• H5 端对本地路径（如 /static/xxx.jpg）支持较好，但微信小程序不支持直接预览本地临时路径（tempFilePath），必须先上传获得线上 URL 或使用云存储临时链接

多图预览前要过滤无效图片，否则白屏或中断

用户上传后可能混入空值、视频地址、404 图片或跨域资源，一旦进 urls 数组，uni.previewImage 在某些平台（尤其是 iOS App）会直接失败或卡死，且无明确错误提示。

• 务必在调用前 clean 数据：urls = this.imageList.filter(url => url && typeof url === 'string' && !url.startsWith('data:') && !url.includes('video'))
• 避免把 videoUrl 或 null、undefined 误塞进数组，常见于从接口拉取的混合媒体列表
• 微信小程序中，如果某张图加载超时或 404，整个预览器可能停留在 loading 状态，建议提前用 uni.getImageInfo 做轻量校验（非必须，但关键场景值得加）

loop 和 indicator 在不同端表现不一致，别默认开启

loop: true 看起来很友好，但实际在 H5 端不生效，在部分安卓 App 上滑到末尾再划会卡顿；indicator: 'number' 在微信小程序显示为“1/3”，但在 H5 端压根不显示——这些不是 bug，是各端原生组件能力差异导致的。

• 如果你需要全端统一指示器，别依赖 indicator，改用自定义悬浮层 + current 监听回调（success 不触发，得靠 uni.onPreviewImageChange，但仅 App 支持）
• loop 建议保持 false，除非你明确只跑 App 端且已测试过边界滑动体验
• 微信小程序支持 longPressActions，但 H5 和 App 不支持，想加保存/分享按钮就得自己实现覆盖层，不能指望 API 原生带

点击事件绑定位置不对，会导致 current 索引错乱

常见写法是在 v-for 里给 image 绑 @click="previewImage(index)"，看起来没问题，但如果列表是动态渲染（比如分页加载、搜索过滤），index 就是当前页的局部索引，不是全局数组下标。

• 更稳妥的方式是传原始数据项：@click="previewImage(item)"，然后在方法里用 urls.indexOf(item) 查索引（前提是 item 是原始 URL 字符串）
• 或者维护一个扁平化图片数组 allImages，所有预览都基于它，点击时传 allImages.indexOf(src)
• 千万别在循环中用 :key="index" 同时又用 index 当预览索引——Vue 列表重排后 key 不变，但 index 已变，极易出错

实际最麻烦的不是怎么调用，而是你永远不知道用户点的那张图，在另一台手机上是不是还能正常加载出来。网络、缓存、CORS、临时路径失效……这些不会报错，只会让预览器沉默地卡住。