uni.setClipboardData 返回 Promise，应使用 .then()/.catch() 或 async/await；支付宝小程序需单独判断平台并降级为回调；iOS/H5 需用户主动交互触发，data 必须为字符串，验证成功需配合 uni.getClipboardData 比对。
uni.setClipboardData 的回调怎么写才有效
uni-app 里 uni.setClipboardData 不支持传统 success/fail/complete 回调，它返回的是 Promise —— 写 callback 参数不仅无效，还会被忽略，甚至在某些平台（如微信小程序）直接报错 fail invalid param: success。
正确做法是用 .then() 和 .catch()，或者 async/await。H5、微信小程序、App（v3）均支持 Promise 版本，但注意：支付宝小程序仍只支持回调形式（需单独判断）。
- ✅ 推荐写法（Promise）：
uni.setClipboardData({ data: 'hello world' }).then(() => { console.log('复制成功') }).catch(err => { console.error('复制失败', err) }) - ⚠️ 错误写法（会被忽略或报错）：
uni.setClipboardData({ data: 'x', success() {} }) - ? 支付宝小程序兼容处理：需先用
uni.getSystemInfoSync().platform === 'alipay'判断，再降级为回调写法
为什么 setClipboardData 在 iOS App 或 H5 上偶尔不生效
不是代码问题，而是平台限制：iOS 原生 Webview 和部分 H5 环境要求用户有「主动交互行为」（比如 click、tap）才能触发剪贴板写入；直接在 onLoad 或定时器里调用会静默失败。
- 必须绑定在用户可点击的元素上，例如按钮的
@click事件 - H5 下若页面未聚焦（比如切到后台再切回），
document.hasFocus()为 false 时也可能失败 - iOS App（v3）需确保
manifest.json → 模块权限 → "ClipBoard"已勾选，否则真机无提示直接失败 - 不要在
onShow或onReady中调用 —— 这些钩子不保证用户处于可交互状态
data 参数传对象或数字会怎样
data 只接受字符串类型。传其他类型不会报错，但会静默转成字符串（比如 {a:1} → "[object Object]"，123 → "123"），这往往不是你想要的结果。
- ✅ 安全写法：显式
String(x)或模板字符串：`${obj.id}-${obj.name}` - ✅ 复杂数据建议
JSON.stringify(obj)，但注意长度限制（多数平台上限约 10MB，实际建议控制在几 KB 内） - ❌ 避免直接传
undefined或null—— 微信小程序会报fail system error，H5 可能写入空字符串
如何检测用户是否真的复制成功（不只是 Promise resolve）
Promise resolve 仅表示 API 调用成功，并不代表内容已进入系统剪贴板。尤其在 iOS Safari 或某些安卓定制浏览器中，可能因权限或策略拦截而无声失败。
- 最可靠方式：紧接着调用
uni.getClipboardData()并比对内容（注意加try/catch，因为该 API 也可能被拒绝） - 示例：
uni.setClipboardData({ data: 'test' }) .then(() => uni.getClipboardData()) .then(res => { if (res.data === 'test') console.log('确认写入成功') }) .catch(err => console.warn('读取剪贴板失败，可能被拦截', err)) - ⚠️ 注意：H5 下
getClipboardData需用户再次交互（如点击）才能调用，否则会抛出安全错误
button 的 bindtap 里调用，但 H5 要求事件路径上不能有 preventDefault，iOS 还要求 touchstart 到 touchend 间隔不能太长。这些细节不验证，就永远不知道为什么“明明点了按钮却没复制”。 
