uni.setClipboardData必须在用户点击事件第一层直接调用，不可置于setTimeout、Promise.then等异步回调中；data参数须为非空字符串，各端需配置对应权限，H5需降级使用navigator.clipboard.writeText并校验安全上下文，同时提供即时UI反馈与防重复点击机制。
uni.setClipboardData 必须在用户点击事件第一层调用
直接在 @tap 绑定的函数体开头调用 uni.setClipboardData，否则静默失败——不报错、不复制、控制台也无提示。常见错误包括：放进 setTimeout、Promise.then、this.$nextTick 或接口回调里，这些都会脱离用户手势上下文，iOS 和小程序端直接拒绝，H5 端则可能因非安全上下文或非主动触发而失效。
- ✅ 正确写法：
handleCopy() { uni.setClipboardData({ data: this.text }) } - ❌ 错误写法：
this.$nextTick(() => uni.setClipboardData(...))、fetch().then(() => uni.setClipboardData(...)) - 如果内容需异步获取（如从接口读取口令），确保请求发起和复制调用都在同一点击事件链中，且复制紧跟数据就绪之后，不跨宏任务
data 参数必须是字符串，且不能为 null/undefined/空对象
uni.setClipboardData 的 data 字段只接受字符串。传 number、object、null 或 undefined 会静默转成 [object Object] 或空串，剪贴板实际没变。尤其容易在动态拼接或未判空时踩坑。
- 务必提前做类型处理：
String(this.value)或JSON.stringify(this.obj)，再传入 - 对可能为空的字段加守卫：
if (!this.text?.trim()) return - H5 端若传入非法值，
fail回调可能不触发，只能靠视觉反馈+状态锁定来暴露问题
App 和小程序端必须提前配权限，H5 需降级兜底
权限缺失是真机静默失败的最常见原因，各端要求不同，缺一不可：
- iOS：在
manifest.json→ 「App 设置」→ 「iOS 设置」中勾选「剪贴板」，且**必须重新云打包**才生效 - Android：在
manifest.json→ 「模块权限配置」启用clipboard模块 - 微信小程序：在
manifest.json的mp-weixin节点下声明"permission": { "scope.writeClipboard": { "desc": "用于自动填入口令" } } - H5：不支持
uni.setClipboardData，需手动 fallback 到navigator.clipboard.writeText（HTTPS + 用户手势）或document.execCommand('copy')（兼容老浏览器），并检测window.isSecureContext
复制后要给即时视觉反馈，别只靠 toast
用户点击图标后，若仅依赖 uni.showToast，在部分安卓厂商系统（如华为 EMUI）或旧版微信基础库中会被拦截，导致“点了没反应”的错觉。更可靠的是结合 UI 状态锁定与轻量提示：
- 按钮点击后立即置灰 + 文字改为“已复制”，2 秒后恢复可点状态
- 配合
uni.showToast({ title: '已复制', icon: 'none', duration: 1500 })，但不作为唯一反馈 - 避免连续点击：用
isCopying标志位临时禁用，防止多次触发失败或重复写入 - 失败时必须进
fail回调并明确提示，H5 端尤其要注意navigator.clipboard抛出的NotAllowedError或TypeError
真正难的不是调 API，而是把「用户点一下」这个动作，严丝合缝地贯穿到权限配置、数据预处理、平台降级和反馈闭环里——漏掉任一环，都会变成“点了没反应”，且毫无日志可查。
