navigator.clipboard.writeText() 必须在用户手势同步上下文中调用，不可异步；兼容旧浏览器需回退至 execCommand；复制中文或换行符需注意空白处理；应提供按钮状态反馈并捕获错误。
点击按钮触发 navigator.clipboard.writeText() 失败
直接调用 navigator.clipboard.writeText() 会报错 "Failed to execute 'writeText' on 'Clipboard': Permission denied"，不是权限没开，而是浏览器要求该操作必须发生在用户手势（如 click、keydown）的同步执行上下文中——也就是说，不能丢进 setTimeout、Promise.then 或异步回调里。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 绑定事件必须用原生
addEventListener('click', ...)或内联onclick，确保是用户主动触发 - 复制逻辑写在事件回调第一层，不要包裹在异步函数里
- 避免在
fetch成功回调里调用复制，哪怕只是想“加载完再复制”，得改成先复制、再请求，或用按钮二次点击
兼容性差：Safari 13.1+ 和旧版 Edge 不支持 navigator.clipboard
IE 全系不支持，Safari 在 13.1 之前也没有 navigator.clipboard。如果需兼容 Safari 12 或更老版本，得回退到 document.execCommand('copy') 方案，但注意它已被废弃且限制更多。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 优先检测
'clipboard' in navigator，存在则用writeText() - 否则创建临时
<textarea></textarea>，设为readonly并select()，再调用document.execCommand('copy') - 记得移除临时元素并恢复焦点，否则影响页面可访问性
复制中文或含换行符的文本时格式错乱
常见现象：粘贴后文字挤成一行、空格被吞、换行变成 %0A。根本原因是部分旧方案对空白字符处理不严谨，或未正确设置 textarea 的 wrap="off" 和样式。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
navigator.clipboard.writeText()时，传入原始字符串即可，它原样保留所有空白和换行 - 若用
execCommand回退方案，务必给临时<textarea></textarea>设置：style="position: absolute; left: -9999px; width: 1px; height: 1px;"，并调用.select()前确保元素已挂载到document.body - 避免用
innerText提取内容——它会折叠空白；改用textContent或直接绑定变量
按钮状态反馈缺失导致用户重复点击
用户点完没反应，容易连点三次，既可能触发多次复制（虽无害），也可能掩盖失败——比如权限拒绝后没提示，用户以为成功了。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 点击后立即禁用按钮（
button.disabled = true），并改文案为 “已复制” 或加个对勾图标 - 3 秒后自动恢复，用
setTimeout(() => { btn.disabled = false; btn.textContent = '复制'; }, 3000) - 捕获
writeText()的catch，对DOMException中的"NotAllowedError"（权限问题）和"SecurityError"（非安全上下文）做区分提示
真正麻烦的是跨域 iframe 场景下无法访问父页面剪贴板，或者页面运行在 file:// 协议下——这时候连 navigator.clipboard 都是 undefined，得提前检查协议和上下文。
