uni-app 中复制文本必须使用 uni.setClipboardData() 而非 navigator.clipboard，因其跨端兼容且自动适配各平台剪贴板能力，而后者在 App/小程序端不存在、H5 端受限于安全上下文和用户手势触发。
uni-app 复制文本不能直接用 navigator.clipboard，得走 uni.setClipboardData() —— 这是跨端兼容的唯一可靠方式。
为什么 navigator.clipboard.writeText() 在 uni-app 里大概率失效
因为 navigator.clipboard 是浏览器原生 API，在 H5 端需用户主动触发（如点击事件）、且部分安卓 WebView 或微信内置浏览器不支持；App 和小程序端根本不存在这个对象。uni-app 的 uni.setClipboardData() 才是统一抽象层，内部自动适配各端能力。
- 微信小程序：调用
wx.setClipboardData - App（iOS/Android）：调用原生剪贴板接口
- H5：降级为
document.execCommand('copy')（需 textarea 临时聚焦）或现代navigator.clipboard（仅限安全上下文） - 注意：H5 下若页面非 HTTPS 或非用户手势触发，
uni.setClipboardData()可能静默失败，不报错也不复制
uni.setClipboardData() 的正确调用姿势
必须在用户可感知的交互回调中调用（比如按钮 click、tap），不能放在 onLoad、mounted 或异步回调里（如 setTimeout、Promise.then）。
- ✅ 正确：
<button @tap="handleCopy">复制</button>→handleCopy() { uni.setClipboardData({ data: 'hello' }) } - ❌ 错误：
onLoad() { setTimeout(() => uni.setClipboardData({ data: 'hello' }), 100) }（H5/App 极可能失败） - 参数
data必须是字符串，传数字、对象会转成[object Object]，记得先String()或JSON.stringify() - 建议加
success/fail回调判断结果，尤其 H5 端失败时不抛异常，只进fail
复制成功后怎么给用户反馈？别只靠 uni.showToast
单纯弹 toast 不够直观，用户可能没注意或误以为失败。更稳妥的做法是「视觉反馈 + 短暂状态锁定」。
- 复制按钮点击后立即置灰 + 改文字（如“已复制”），2 秒后恢复，避免重复点击
- 配合
uni.showToast({ title: '已复制', icon: 'none', duration: 1500 })，但不要依赖它作为唯一提示 - 注意：小程序端
uni.showToast在某些旧版基础库中可能被拦截（如 iOS 微信 8.0.22），建议 fallback 到uni.showModal（仅调试时用）或自定义轻量提示组件 - App 端无此限制，但 Android 部分厂商系统（如华为 EMUI）会屏蔽后台 toast，所以状态变更比弹窗更可靠
特殊场景：复制富文本、带样式的 HTML？不行，只能纯文本
uni.setClipboardData() 只支持纯文本，无法写入 HTML、图片或格式化内容。所谓“复制链接带高亮”“复制代码块保留缩进”，本质都是把格式转义为可读纯文本：
- 链接可拼成
`【标题】${url}`，让用户粘贴到支持 Markdown 的地方自动识别 - 代码片段建议用
JSON.stringify(obj, null, 2)或手动加换行符\n，别指望粘贴到编辑器里自动缩进 - 小程序端若需“复制并跳转”，应分开处理：先复制，再
uni.navigateTo；不能试图把逻辑塞进剪贴板数据 - 真要支持富文本（如微信内分享图文），得走
uni.share或小程序shareMessage，和剪贴板无关
真正容易被忽略的是 H5 端的上下文限制——哪怕你用了 @tap，如果页面由 iframe 嵌入、或当前 tab 是后台页、或用户刚从外链跳转未触发过任何交互，uni.setClipboardData 仍可能静默失败。上线前务必在真实微信、QQ、Safari、Chrome 中分别点按测试，别只信开发工具模拟。
