uni-app 无法自动或静默读取剪贴板，必须由用户手势（如@tap）触发uni.getclipboarddata，且仅获最新单条内容；ios/android/小程序需权限声明与授权，h5完全不支持读取，仅能引导手动粘贴。
uni-app 无法“自动”或“静默”读取剪贴板内容，必须由用户点击等手势触发，且只能拿到当前最新一条值——不是历史记录，也不是列表，更不是实时监听。
uni.getClipboardData 必须在用户点击事件里调用
这个 API 在 iOS 14+、Android 12+、微信/支付宝小程序中均被平台强制要求：调用上下文必须是用户可感知的手势（如 @tap、@click），否则直接返回空字符串或失败。
- ❌ 错误写法：
onLoad、onShow、mounted、setTimeout、Promise.then中调用 → 大概率静默失败 - ✅ 正确写法：按钮绑定
@tap="handlePaste"，函数体第一行就调uni.getClipboardData - 小程序端若未在
manifest.json的mp-weixin节点下声明"scope.writeClipboard"权限，iOS 真机连弹窗都不会出现，直接拒绝 - App 端 iOS 首次读取会弹系统级授权框：“是否允许 [你的App] 访问剪贴板？” 用户点“不允许”后，后续所有调用都返回
errMsg: "getClipboardData:fail auth deny"，且无法代码重试
H5 平台根本不能读取剪贴板
uni.getClipboardData 在 H5 环境下完全不支持读取——既不会进 success，也不会进 fail，控制台无报错，就是静默失效。这不是 bug，是浏览器安全策略硬限制。
- Chrome/Firefox/Safari 均禁止网页主动读取剪贴板，除非使用
navigator.permissions.query({name:'clipboard-read'})+navigator.clipboard.readText()，但该组合仅限 HTTPS + 用户手势 + 主动请求权限，且兼容性差（iOS Safari 不支持readText） - 所以 H5 页面如果需要“粘贴口令”，只能引导用户手动
Ctrl+V，或提供显式“粘贴”按钮（但点下去也没法自动填，只是聚焦输入框） - 别尝试用
document.execCommand('paste')—— 已废弃，H5 不支持，App 和小程序也不认
读出来是空字符串？先清洗不可见字符
微信转发链接、小程序分享口令常含零宽字符（如 \u200b），看着像空，但 res.data.length > 0，res.data.trim().length 也可能非零，导致判断逻辑出错。
- 建议统一清洗：
res.data.replace(/[\u200b-\u200f\u202a-\u202f]/g, '') - 再做空值判断：
if (!cleanedData || !cleanedData.trim()) { ... } - 输入框赋值前务必清洗，否则用户看到的是“看不见的口令”，提交失败还查不出原因
想“监听”剪贴板变化？只能轮询模拟
uni-app 没有原生监听能力。所谓“自动识别复制内容”，实际是靠定时轮询 + 缓存比对实现的，且只在当前页面生命周期内有效。
- 轮询间隔设为
1000ms较稳妥；太密耗电，太松漏操作 - 必须在
onShow启动定时器，onHide清除 —— iOS 切后台后定时器可能被 suspend，Android 可能被系统 kill - 每次读取后与上一次值比对：
if (newData !== lastClipboard) { /* 触发业务逻辑 */; lastClipboard = newData; } - 缓存数组长度建议限制在
5～10条，避免长期驻留页面时内存持续增长
真正容易被忽略的是：所谓“读取剪贴板”，从来不是一次配置就能永久生效的功能。它高度依赖平台权限状态、用户操作上下文、甚至系统版本和厂商定制 ROM 的拦截策略。每次上线前，务必在 iOS 真机、安卓主流机型、微信/支付宝小程序、H5（HTTPS 环境）四端分别验证手势触发路径和失败反馈逻辑。
