iOS真机中uni.getClipboardData返回空字符串是因系统拦截非用户手势调用；必须用@click同步触发，且需在manifest.json中启用剪贴板模块并重新云打包。
uni.getClipboardData 在 iOS 真机返回空字符串
不是 API 坏了，而是系统拦截了非用户手势触发的读取行为。iOS 14+ 强制要求 uni.getClipboardData 必须由 @click 或 @tap 同步调用，onLoad、onShow、setTimeout、Promise.then 全部无效。
常见错误现象：
- 控制台无报错，
res.data是空字符串，但res.data.length > 0 -
JSON.stringify(res.data)显示"\u200b"等零宽字符 - 首次调用后没弹窗，后续始终返回空 —— 用户已点「不允许」
实操建议：
- 按钮必须用
@click="handlePaste"，不能用@touchstart或@longpress - 读取后立即清洗：
res.data.replace(/[\u200b-\u200f\u202a-\u202f\uFEFF]/g, '').trim() - 加兜底提示：
uni.showToast({ title: '请前往设置 > 隐私与安全性 > 剪贴板开启权限' })
uni.setClipboardData 在 iOS 微信/Safari 复制失败
iOS 对写入操作虽不弹授权框，但对调用上下文更敏感：必须在用户点击的同步执行栈内完成，任何 await 或异步链都会中断上下文。
典型错误写法：
-
async handleCopy() { const link = await getShortLink(); uni.setClipboardData({ data: link }) }→ iOS 必败 -
uni.setClipboardData传了number、null或含换行符的字符串 → 直接fail且无类型提示
实操建议：
- 若需异步获取内容，用
setTimeout(() => { uni.setClipboardData(...) }, 0)强制回归同步上下文（实测 iOS Safari / 微信有效） - 写入前校验：
if (typeof text !== 'string' || !text.trim()) return - 避免传 HTML、富文本或带
\r\n的多行内容；纯文本最稳
iOS 原生 App 模块未启用导致静默失败
uni-app 打包为 iOS App 时，uni.getClipboardData 和 uni.setClipboardData 不会报错，也不会触发回调 —— 就是彻底没反应。根本原因是原生能力没打开。
关键动作只有一步：
- 打开
manifest.json→ 「App 设置」→ 「iOS 设置」→ 勾选「剪贴板」模块 - 保存后必须重新「云打包」，本地运行或调试器不会生效
注意：这个配置和小程序的 mp-weixin.permission 无关，是独立开关。
H5 平台误用 uni.setClipboardData 导致无响应
uni.setClipboardData 在 H5 端是空实现，调用它等于什么都没做。浏览器真正认的是 navigator.clipboard.writeText，但它有硬性限制。
三个条件缺一不可：
- 页面必须是 HTTPS 或
localhost（http://127.0.0.1不行，http://192.168.x.x也不行） - 必须在
@click回调体内直接调用，不能进async/await或then - 部分安卓 WebView（如旧版 UC）不支持
navigator.clipboard，需降级到document.execCommand('copy')
实操建议：
- 先判断平台：
if (uni.getSystemInfoSync().platform === 'h5') - 再检测安全上下文：
if (navigator.clipboard && window.isSecureContext) - 降级方案里临时
<textarea></textarea>要手动remove()，否则内存泄漏
最常被忽略的点：iOS 上“没反应”往往不是代码问题，而是 manifest.json 里那个勾没打，或者云打包没重做。真机测试前，先确认这一步是否完成。
