navigator.clipboard.write() 必须传 ClipboardItem 实例，需同时提供 text/plain 和 text/html 格式 Blob，且 HTML 必须含完整结构与编码声明；Safari 不支持 text/html 写入，须降级为 writeText() 并提示用户。
clipboard.write() 必须用 ClipboardItem 构造多格式数据
直接传字符串给 navigator.clipboard.write() 会报错，它只接受 ClipboardItem 实例。而一个 ClipboardItem 就是一组 MIME 类型到 Blob 的映射——你要同时提供 text/plain 和 text/html，浏览器才会在粘贴时按目标应用能力自动选格式。
常见错误是只塞一个 text/html Blob，结果粘贴到记事本里空白；或漏设编码，中文变乱码。
-
text/plainBlob 必须存在，内容建议用textContent提取（不是innerText），避免样式依赖 -
text/htmlBlob 的type字符串必须严格为"text/html"，不能是"text/html;charset=utf-8"（那是 Blob 构造参数里的 encoding） - 两个 Blob 都要显式指定
{ type: "text/plain;charset=utf-8" }或{ type: "text/html;charset=utf-8" }，否则中文可能出问题
HTML Blob 必须含合法片段结构，不是随便写个 hello
Word、Outlook、Apple Notes 等应用对 text/html 格式有隐性要求：必须包含 包裹，且最好带 <meta charset="utf-8"> 声明。更严格的（如 Windows 端 Outlook）还要求 CF_HTML 片段头，比如 <!--StartFragment--> 和 <!--EndFragment-->。
不加这些，Chrome 可能照常复制，但粘贴进 Word 就退化成纯文本，样式全丢。
- 最小可用 HTML 结构示例：
<meta charset="utf-8"> <b>加粗</b>和@#@#@#@#@#@#@#@#@#@0 - 不要用
innerHTML直接拼接用户输入，需做基本 XSS 过滤（至少转义<code>>"） - 如果原始内容来自
contenteditable，优先用range.cloneContents()+document.createRange().createContextualFragment()提取结构化 HTML，而非字符串替换
write() 在 Safari 中不支持 text/html 写入，别默认它能用
navigator.clipboard.write() 在 Safari（截至 2026 年 5 月）仍不支持 text/html 类型写入，调用后会静默失败或抛 NotAllowedError。它只认 text/plain 和图片（image/png 等），HTML 被忽略。
这意味着：你写了完整合法的 ClipboardItem，在 Safari 里粘贴到 Notes 或 Pages，依然只有纯文本——不是你代码错了，是浏览器没实现。
- 检测方式：
if (!('write' in navigator.clipboard))或更细粒度地 try/catch 后检查err.name === 'NotAllowedError'且err.message.includes('html') - 降级策略只能是 fallback 到
navigator.clipboard.writeText()（纯文本）+ UI 提示“富文本仅在 Chrome/Firefox/Edge 中生效” - 不要尝试用
document.execCommand('copy')替代：它无法注入text/html，且已废弃，Chrome 95+ 默认禁用
用户手势 + 安全上下文是硬门槛，绕不过
navigator.clipboard.write() 和 writeText() 一样，必须由用户点击、触摸、键盘事件（如 keydown 且 event.ctrlKey）触发。在 setTimeout、fetch.then、useEffect 初始化中调用，必然失败。
而且页面必须运行在 HTTPS 或 localhost 下，HTTP 页面里 navigator.clipboard 是 undefined。
- 验证是否可用：
console.log(navigator.clipboard && window.isSecureContext)，两个都为true才行 - 按钮绑定推荐用
addEventListener('click', handler, { once: true })，防止重复点击并发调用 - 错误处理别只打
console.error，要给用户明确反馈：“复制失败：请确认是否在安全环境（HTTPS）下，并通过点击操作触发”
实际最易被忽略的点是：你以为构造了双格式 Blob 就万事大吉，但 Safari 不吃这套，而你又没做运行时能力检测和降级提示——用户在 Mac 上点完按钮毫无反应，还以为功能坏了。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
