uni.getClipboardData 返回空字符串主因是触发时机不当、零宽字符污染或平台权限缺失；需确保用户手势调用、清理不可见字符并正确配置权限。
uni.getClipboardData 返回空字符串，大概率不是 API 坏了，而是触发时机、平台限制或内容污染导致的。
调用时机不在用户手势上下文（iOS/Android 最常见）
iOS 14+ 和多数 Android 厂商（华为、小米等）强制要求 uni.getClipboardData 必须由用户主动操作（如 click、tap）触发，不能放在 onLoad、onShow、定时器或异步回调里。
- 错误写法：
onShow() { uni.getClipboardData({ success: res => console.log(res.data) }) }→ iOS 真机直接返回空，Android 可能静默失败 - 正确做法：绑定按钮点击事件，例如
<button @click="handlePaste">粘贴口令</button>，在handlePaste里调用uni.getClipboardData - 注意：Vue 的
@touchstart不算有效手势，必须是@click或@tap
剪贴板内容本身含不可见字符（微信/钉钉转发最典型）
用户从微信复制链接或口令时，常带零宽字符（如 \u200b、\u200c、\u200d），看着像空字符串，但 res.data.length > 0，res.data.trim() 也去不掉。
- 验证方式：
console.log(JSON.stringify(res.data))→ 如果看到"\u200b"类似输出，就是它 - 清理建议：
res.data.replace(/[\u200b-\u200f\u202a-\u202f\uFEFF]/g, '') - 额外过滤：顺手去掉首尾空格、换行、制表符：
.trim().replace(/^[\r\n\t\s]+|[\r\n\t\s]+$/g, '')
小程序未声明权限或 H5 平台误用
微信小程序必须在 manifest.json 的 mp-weixin 节点下配置权限，H5 则根本不能用 uni.getClipboardData。
- 小程序缺配置 → 报错或返回空：
"permission": { "scope.writeClipboard": { "desc": "用于自动填入口令" } }，漏掉desc字段也会失败 - H5 平台调用
uni.getClipboardData→ 直接返回空对象或fail回调，且无提示；必须改用navigator.clipboard.readText()（仅 HTTPS + 用户手势） - 判断平台再调用：
const { platform } = uni.getSystemInfoSync(); if (platform !== 'h5') { uni.getClipboardData(...) }
用户已拒绝授权且未重试
iOS 真机首次调用会弹系统级授权弹窗，一旦点「不允许」，后续所有调用都静默失败，fail 回调甚至不触发。
- 现象：
uni.getClipboardData既没success也没fail，控制台安静如鸡 - 解决路径：提示用户手动开启 → 「设置 > 隐私与安全性 > 剪贴板」→ 找到你的 App 开关打开
- 无法代码绕过，这是系统级限制；可加一层兜底提示：
uni.showToast({ title: '请前往系统设置开启剪贴板权限' })
真正难处理的不是“怎么读”，而是“读出来是不是人眼可见的干净字符串”——零宽字符、平台权限、触发上下文，三者缺一都会让 res.data 看似为空。别急着查 API 文档，先 console.log(JSON.stringify(res.data)) 看一眼原始内容。
