真正有效的复制反馈是「视觉锁定+短暂蒙层+引导动线」，需复用新手引导遮罩结构，通过响应式变量控制显隐，用 createSelectorQuery 主动查询目标位置，配合状态锁防重复触发，并统一收口关闭逻辑。
复制成功后直接弹 toast 容易被当成操作本身，用户感知弱；真正有效的反馈是「视觉锁定 + 短暂蒙层 + 引导动线」，但 uni-app 没有开箱即用的蒙层引导组件，必须手动组合实现。
怎么用遮罩+高亮实现复制后的引导蒙层
本质是复用新手引导组件的遮罩逻辑，但触发时机从「首次启动」改为「复制成功后」。关键不是重写一套，而是复用已有 guide-mask 结构，只改控制逻辑：
- 把引导组件的
visible改为响应式变量（如showCopyGuide），初始值false - 在
uni.copyToClipboard().then()成功回调里设showCopyGuide = true，不要等uni.showToast结束 - 高亮区域定位目标元素需用
uni.createSelectorQuery()主动查，不能依赖ref（H5 和小程序 ref 行为不一致） - 蒙层层级必须高于所有内容，
z-index: 9999是底线，App 端还需加position: fixed防止滚动偏移
为什么复制后蒙层一闪就消失或定位错位
常见于异步时机和 DOM 就绪判断失误：
-
onLoad或mounted里直接查元素位置 → 此时 DOM 可能未渲染完成，返回boundingClientRect为空或0 - 没用
setTimeout(() => { query.exec() }, 0)或nextTick延迟查询，尤其在 App 端 WebView 渲染节奏慢 - 高亮区域用
left/top/width/height绝对定位，但父容器用了transform（如 swiper 的 translateX），导致坐标系偏移 - 微信小程序真机上
selectorQuery.in(this)必须显式传入当前组件实例，漏写会查到全局节点
如何避免连续点击多次触发蒙层
蒙层本身不防抖，得靠状态锁控制触发源头：
- 复制按钮加
isCopying标志位，成功后不立即释放，等蒙层关闭再设false - 蒙层关闭逻辑统一收口到一个方法（如
closeCopyGuide()），里面重置isCopying和showCopyGuide - 蒙层内「知道了」按钮的
@click必须调用该关闭方法，不能只改showCopyGuide - 若用户快速连点复制按钮，第二次点击时
isCopying === true直接 return，不进复制流程
App 和小程序端蒙层表现差异怎么处理
核心矛盾是 App 端 WebView 对 fixed 和 pointer-events 支持不稳定：
- H5 端可用
pointer-events: none让蒙层透传点击，App 端必须用plus.webview.currentWebview().setStyle({ softinputMode: 'adjustResize' })防键盘顶起 - 小程序真机上蒙层遮不住原生组件（如
map、video），需提前用v-if卸载这些组件，或改用 canvas 绘制遮罩 - 鸿蒙元服务目前不支持
z-index跨层穿透，蒙层必须放在<page-meta>同级，且不能嵌套在scroll-view内 - 所有样式单位统一用
rpx，避免 App 端 px 计算偏差导致高亮框错位
蒙层引导真正的难点不在显示，而在「何时关」——它必须等用户明确看到提示、理解动作含义后再收起，硬设 2 秒自动关闭反而破坏体验。最稳妥的是让用户主动点击「知道了」，且这个按钮的位置和文案要足够醒目，别藏在角落或写成「OK」。
