navigator.clipboard.writeText()是当前最简复制方案，需HTTPS或localhost环境、click事件触发，须try/catch处理权限错误，禁用异步调用，iOS首次需用户激活，降级用document.execCommand需动态textarea并focus/select。
直接用 navigator.clipboard.writeText() 最简方案
只要页面跑在 https:// 或 http://localhost 下，且按钮绑定的是 click 事件，就能一行搞定复制。别写 document.execCommand('copy')——它已在 Chrome 98+ 和新版 Firefox 中彻底失效。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 确保按钮是原生
<button>，用addEventListener('click', ...)或onclick属性绑定 - 复制内容从
data-*属性读取最干净，比如<button data-code="X9F2K7">复制提取码</button> - 必须加
try/catch，否则权限被拒时静默失败，用户完全没反馈 - 不要在
setTimeout、fetch.then或 Vue/React 的异步更新钩子中调用——脱离用户手势链就必报"NotAllowedError"
button.addEventListener('click', async () => {
const code = button.dataset.code;
try {
await navigator.clipboard.writeText(code);
button.textContent = '已复制';
} catch (err) {
console.warn('复制失败:', err.name);
button.textContent = '复制失败';
}
});
复制 <pre> 或 <code> 里的代码块内容
目标不是 input 值，而是预格式化文本，直接取 textContent.trim() 即可。注意：iOS Safari 首次调用前需用户点击激活剪贴板权限，所以第一次点没反应不是 bug，是浏览器策略。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
textContent（非innerText），避免样式干扰和换行折叠 - 对
<pre>内容做.trim()，否则可能多出空行或缩进空格 - 别给
<pre>加contenteditable="true"——语义错误，还可能触发焦点冲突 - 如果要保留 HTML 格式（如粘贴到 Notion），得用
navigator.clipboard.write()+ClipboardItem，但 Safari 不支持，仅限纯文本场景才推荐走这条路
兼容 IE11 和老 Safari 的降级方案
当 navigator.clipboard 不存在（如 IE11、Safari 12.1 或禁用 API 的环境），只能退回 document.execCommand('copy')。但它不返回 Promise，也不抛错，失败时只默默返回 false，必须手动判断。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 先检查
if (!navigator.clipboard)，再启用降级逻辑 - 动态创建
<textarea>，设style="position:fixed;top:-9999px;"（不能用display:none） - 必须先
focus()再select()，iOS Safari 尤其敏感 - 复制后立即
remove()，否则残留 DOM 可能影响后续操作 - 别用
alert()做反馈——打断流程、遮挡 UI、iOS 上常被拦截
function fallbackCopy(text) {
const el = document.createElement('textarea');
el.value = text;
el.style.cssText = 'position:fixed;top:-9999px;';
document.body.appendChild(el);
el.focus();
el.select();
const success = document.execCommand('copy');
document.body.removeChild(el);
return success;
}
按钮状态管理容易被忽略的细节
“已复制”文字切换看似简单，但多数人栽在两个地方：一是改了文字不恢复，二是用 innerHTML 替换破坏事件绑定。更隐蔽的问题是，在 React/Vue 中直接改 textContent 可能被下一次渲染覆盖。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 原始文案存进
data-original-text，比如button.dataset.originalText = button.textContent - 成功后只改
textContent，不用innerHTML—— 更快、更安全、不执行脚本 - 恢复文案别用
setTimeout(..., 2000)自动重置；等用户下次点击再恢复，避免干扰操作节奏 - 移动端双击可能触发两次 click，加个简单防抖（如 300ms 内忽略重复）比强行恢复更可靠
真正卡住人的从来不是 API 调用那行代码，而是 HTTPS 环境校验、用户手势同步性、降级路径的静默失败，以及按钮状态在不同框架下的生命周期错位。这些点不提前踩一遍，上线后问题只会出现在最不方便调试的用户手机上。
