uni.setClipboardData在H5端不生效，需按平台分路径处理：App和小程序原生支持，H5需降级为navigator.clipboard.writeText()或document.execCommand('copy')，且须用户手势触发、HTTPS环境。
uni-app里调用uni.setClipboardData没反应？先确认平台支持
这个 API 在 H5 平台默认不生效，微信小程序和 App（iOS/Android）才原生支持；H5 需要降级为 document.execCommand('copy') 或现代 navigator.clipboard.writeText()，但后者有安全限制（必须用户手势触发、页面需 HTTPS）。别一上来就写 uni.setClipboardData 然后在浏览器里点不动就以为代码错了。
怎么写一个跨平台兼容的复制函数？
不能只依赖 uni.setClipboardData，得按平台分路径处理。关键逻辑是：优先走 uni.setClipboardData（小程序/App），H5 单独处理，同时捕获异常避免阻断流程。
- 用
uni.getSystemInfoSync().platform判断当前环境，比写死条件更可靠 - H5 下优先尝试
navigator.clipboard.writeText()，失败再 fallback 到execCommand（兼容老浏览器） - 所有异步操作都要加
try/catch，uni.setClipboardData在部分安卓 WebView 里也会 reject - 复制成功后建议用
uni.showToast提示，别只靠 console.log
const copyText = async (text) => {
try {
const { platform } = uni.getSystemInfoSync();
if (platform === 'h5') {
if (navigator.clipboard && window.isSecureContext) {
await navigator.clipboard.writeText(text);
} else {
const input = document.createElement('input');
input.value = text;
document.body.appendChild(input);
input.select();
document.execCommand('copy');
document.body.removeChild(input);
}
} else {
await uni.setClipboardData({ data: text });
}
uni.showToast({ title: '已复制', icon: 'none' });
} catch (err) {
console.error('复制失败:', err);
uni.showToast({ title: '复制失败', icon: 'none' });
}
};
为什么点击按钮没触发复制？检查这三点
常见卡点不在 API 调用本身，而在上下文或权限上：
- 确保调用发生在用户主动触发的事件回调里（比如
@click），不能在onLoad或定时器中直接调；H5 的navigator.clipboard会拒绝非用户手势触发的调用 - App 端需要在
manifest.json里开启「剪贴板」权限（iOS/Android 均需勾选），否则静默失败 - 微信小程序要求基础库 >= 1.1.0，且真机调试时注意「调试基础库版本」是否达标；开发工具模拟有时不准，务必真机验证
复制长文本或富文本要注意什么？
uni.setClipboardData 只接受字符串，传对象或 HTML 会报错；如果想复制带样式的文本（比如从 rich-text 组件提取），得先做清洗：
- 用正则或 DOM API 剥离 HTML 标签：
text.replace(/]+>/g, '') - 避免复制大量空白符或不可见字符（如 \u200B），它们可能导致粘贴后格式错乱
- 超长文本（>10MB）在某些安卓 WebView 里可能触发内存警告，建议截断提示：“内容过长，已复制前 200 字”
真正麻烦的是“复制后粘贴到微信聊天窗丢失换行”，这不是 uni-app 的问题——微信自己的粘贴逻辑会过滤 \n，得换成 \r\n 或空格占位，这个得后端或业务层配合处理。
