uni-app如何调用系统剪贴板setClipboardData-uni-app-PHP中文网

uni.setclipboarddata不能跨端通用，h5端完全不支持且静默失败；app和小程序可用，但必须满足用户点击事件第一层调用、data为字符串、平台权限正确配置三重条件。

uni-app如何调用系统剪贴板setclipboarddata

uni.setClipboardData 不能跨端通用，H5 端完全不支持，强行调用静默失败；App 和小程序可用，但必须满足触发时机、权限配置、参数类型三重硬性条件。

这个 API 表面简单，错一个就彻底失效，且不报错、不弹提示、控制台也无日志：

调用不在用户点击事件的第一层：比如写在 setTimeout、Promise.then、this.$nextTick 或生命周期钩子（onLoad、onShow）里，iOS 和部分安卓 WebView 会直接拦截
data 参数不是字符串：传 number、null、object 会转成空串或 [object Object]，务必先 String(text) 或 JSON.stringify(obj)
平台权限没配：App 端 iOS 需在 manifest.json →「App 设置」→「iOS 设置」勾选「剪贴板」；Android 需在「模块权限配置」启用 clipboard 模块

微信/支付宝等小程序不会自动获得剪贴板写入权限，不声明就静默拒绝：

uni-app

uni-app 是基于 Vue 的跨端开发框架，适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

在 manifest.json 的对应平台节点下添加权限配置，例如微信：

"mp-weixin": {
  "permission": {
    "scope.writeClipboard": {
      "desc": "用于复制链接或订单号"
    }
  }
}

支付宝小程序例外：它不认 uni.setClipboardData，必须用 my.setClipboard，且返回结构是 { text } 而非 { data }
首次调用若被用户拒绝，iOS 会记住状态，后续调用仍失败，需引导用户去「设置 → 隐私与安全性 → 剪贴板」手动开启

uni.setClipboardData 在 H5 下调用后既不进 success 也不进 fail，纯静默失败。必须降级：

优先用 navigator.clipboard.writeText，但仅在 HTTPS 或 localhost 下可用；http://192.168.x.x 本地调试会抛 NotAllowedError
必须由用户手势（click、tap）**直接触发**，包一层 setTimeout 就失效
旧版安卓 WebView（如 UC、QQ 浏览器）不支持 navigator.clipboard，得 fallback 到 document.execCommand('copy')；此时必须创建临时 textarea，调用 .select() 后立即执行 .setSelectionRange(0, txt.length)，否则 iOS Safari 复制为空串

不要裸调 uni.setClipboardData，按平台分流是最稳妥的做法：

先用 uni.getSystemInfoSync().platform 判断当前环境：'app'、'mp-weixin'、'h5' 等
H5 分支要双保险检测：if (navigator.clipboard && window.isSecureContext)，再 await navigator.clipboard.writeText(text)
execCommand 降级时，textarea 必须 append 到 document.body，复制完记得 removeChild，避免 DOM 泄漏
所有分支最后都建议加 uni.showToast 反馈，但别依赖 success 回调——H5 的 navigator.clipboard 是 Promise，而 uni.setClipboardData 是回调风格，混用容易漏 catch