uni.copyToClipboard在App端需配置manifest权限，iOS勾选“剪贴板”，Android启用“clipboard”模块；微信小程序必须由用户手势直接触发，不可异步调用；H5需浏览器支持且须用户主动触发。
uni-app里调用uni.copyToClipboard后没反应？先看平台支持
这个 API 在 H5 和微信小程序里默认可用，但 App 端（iOS/Android）需要额外配置权限和原生能力。不配的话，调用uni.copyToClipboard会静默失败，控制台也不报错——这是最常被卡住的地方。
- iOS：需在
manifest.json的「App 设置」→「iOS 设置」里勾选「剪贴板」权限 - Android：需在
manifest.json的「模块权限配置」中启用「剪贴板」模块（对应clipboard） - H5：依赖浏览器 Clipboard API，Chrome 66+、Edge 79+ 支持，Safari 需用户主动触发（比如点击事件内调用），否则拒绝访问
复制成功后怎么弹提示？别直接uni.showToast
用户手指刚点完就弹 toast，容易被误认为是“复制操作本身”，实际是反馈滞后。更自然的做法是：先执行复制，等 Promise resolve 后再提示；失败则给明确错误反馈。
- 必须用
await或.then()捕获结果，uni.copyToClipboard返回 Promise，不是同步函数 - 不要在 catch 里只写
console.log，至少uni.showToast({ title: '复制失败', icon: 'none' }) - 避免连续快速点击多次触发，可加个
isCopying标志位临时禁用按钮
async handleCopy() {
if (this.isCopying) return;
this.isCopying = true;
try {
await uni.copyToClipboard({ text: this.content });
uni.showToast({ title: '已复制', icon: 'success', duration: 1200 });
} catch (err) {
uni.showToast({ title: '复制失败', icon: 'none' });
} finally {
this.isCopying = false;
}
}
微信小程序里copyToClipboard报错permission-denied？检查上下文
微信小程序对剪贴板的调用有严格限制：必须由用户手势（tap、click）直接触发，不能包裹在 setTimeout、Promise.then 或异步回调里，否则视为非用户主动行为，直接拒绝。
- 错误写法：
setTimeout(() => uni.copyToClipboard(...), 100)、this.$nextTick(() => uni.copyToClipboard(...)) - 正确写法：事件处理器第一层就调用，如
@click="doCopy"，且doCopy内直接 await - 如果内容要动态获取（比如接口返回后再复制），确保请求发起也是用户点击触发的，且复制调用紧跟在数据就绪之后，不跨宏任务
复制长文本或富文本时内容被截断？注意text参数类型
uni.copyToClipboard 只接受字符串，传入对象、数组、HTML 字符串都会转成 [object Object] 或报错。常见于从 rich-text 组件取内容、或未处理换行符。
- 从
<rich-text></rich-text>提取纯文本，别直接取v-html值，用正则或 DOMParser 清洗（App/H5 可行，小程序需提前处理） - 换行符在不同平台表现不一：iOS 剪贴板保留
\n，Android 可能转为空格，H5 一般正常；如需统一，可预处理为\n或 - 超长文本（如 >50KB）在低端 Android 设备上可能触发静默失败，建议前端做长度预警（如 >10000 字符时提示“内容过长，已复制前 1 万字”）
