uni-app 全平台无法监听剪贴板变化，仅能通过轮询+比对实现模拟监听，App端可用Native.js调用原生API实现真监听，H5和小程序端不可用。
uni-app 无法监听剪贴板变化，只能轮询模拟
官方 uni.getClipboardData 是一次性读取 API，不提供事件监听能力。iOS/Android/小程序/H5 全平台均无原生「剪贴板内容变更事件」，所谓“自动更新 UI”必须靠前端自己轮询 + 比对 + 更新视图实现，且仅限 App 端可较稳定运行。
轮询不是万能解法：H5 端受 navigator.clipboard 权限策略限制，无法在后台或非焦点页持续读取；小程序端若不在用户点击后立即调用，uni.getClipboardData 会静默返回空字符串；iOS 真机首次读取还会触发系统弹窗，拒绝后后续调用全失败。
- 轮询间隔建议设为
1000ms，太密耗电、卡顿，太松（如 3000ms+）易漏掉短时复制操作 - 每次读取后必须比对上一次值，避免重复触发
setData或this.$set导致无意义渲染 - 务必在
onShow启动定时器，在onHide清除，否则切后台后 iOS 可能 suspend，Android 可能被系统 kill
App 端可用 Native.js 实现真监听（仅限 Android/iOS）
如果你的项目只跑 App，且需要真正响应式感知剪贴板变更（比如扫码口令自动识别），可绕过 uni.getClipboardData，改用 Native.js 调用原生能力。这是目前唯一接近“监听”的方案，但 H5 和小程序完全不可用。
Android 示例逻辑（需写在 plusReady 后）：
const context = plus.android.importClass('android.content.Context');
const clip = plus.android.invoke(main, 'getSystemService', context.CLIPBOARD_SERVICE');
const clipChangedListener = plus.android.implements('android.content.ClipboardManager$OnPrimaryClipChangedListener', {
onPrimaryClipChanged: function() {
// 这里才是真正触发时机
uni.getClipboardData({
success: res => {
const cleanData = res.data.replace(/[\u200b-\u200f\u202a-\u202f]/g, '');
if (cleanData && cleanData !== lastClipboard) {
lastClipboard = cleanData;
this.$nextTick(() => this.clipboardText = cleanData);
}
}
});
}
});
plus.android.invoke(clip, 'addPrimaryClipChangedListener', clipChangedListener);
- 该方式依赖
plus.android，仅 App 端生效，H5 和小程序调用会报错或静默失败 - iOS 端需用
plus.ios+UIPasteboard实现类似逻辑，但需手动处理线程和内存释放 - 监听器注册后不会自动销毁，必须在
onHide或页面卸载时显式调用removePrimaryClipChangedListener
跨端轮询实现要注意三类典型失败场景
很多开发者写完轮询发现 UI 不更新，不是代码逻辑错，而是踩中平台硬限制：
-
用户手势缺失：在
onLoad、onShow或setTimeout里直接调用uni.getClipboardData→ iOS/Android 均拒绝，返回data: ""或errMsg: "fail auth deny" -
零宽字符干扰：微信转发的口令常含
\u200b，看着像空字符串，但res.data.length > 0→ 必须用res.data.replace(/[\u200b-\u200f\u202a-\u202f]/g, '')清洗后再比对 -
权限未配置或未云打包：iOS 端 manifest.json 未勾选「剪贴板」，或勾选后未重新云打包 → 真机静默失败，无任何提示；小程序端则需在
mp-weixin节点下补全"permission": { "scope.writeClipboard": { "desc": "用于识别口令" } }
别把“轮询”当成“监听”，UI 更新必须主动触发
即使轮询拿到新内容，Vue 的响应式系统也不会自动更新绑定的 v-model 或 {{ clipboardText }} —— 因为轮询是在定时器回调里执行的，不是在 Vue 实例上下文中。
正确做法是：
- 用
this.$nextTick(() => this.clipboardText = cleanData)确保 DOM 更新队列同步 - 如果绑定的是
<input ref="inp">，记得在赋值后加this.$nextTick(() => this.$refs.inp.focus())，方便用户继续编辑 - 避免在轮询中频繁调用
uni.showToast，它会打断用户操作；改用轻量级自定义view+position: fixed提示更可控
真正的难点不在“怎么读”，而在“什么时候能读、读到什么、读完怎么稳稳塞进 UI”。平台差异藏得深，一次没配对权限、一次忘了清洗零宽字符、一次在错误生命周期里调用，UI 就卡在旧状态不动了。
