audio元素的muted属性必须在HTML中声明才有效，即<audio muted autoplay>，仅JavaScript动态设置无效；全站静音需初始muted+禁止无交互play；iOS Safari要求audio为body直系子元素。
audio元素的muted属性必须在HTML中声明才有效
浏览器对自动播放的限制非常严格，muted不是运行时开关，而是“解锁自动播放权限”的前置条件。如果只用 JavaScript 动态设置 audio.muted = true，它不会让已加载的音频静音，更不会让 autoplay 生效——因为此时播放上下文已被拒绝。
真正起作用的写法是直接在 HTML 标签里写死：<audio muted autoplay>。这个 muted 是布尔属性，不带值，也不需要 = "true"。没有它，autoplay 在几乎所有现代浏览器（Chrome、Firefox、Safari、Edge）中都会被无视。
- 仅靠 JS 设置
muted无法绕过首次交互限制 -
muted必须和autoplay同时出现在初始 HTML 中，才可能静音自动播放 - 若音频已开始播放，再设
muted = true可以立即静音，但不能恢复声音（除非用户已交互过）
全站音频静音不能只靠CSS隐藏controls
很多人以为把 <audio> 的控件隐藏（display: none 或 visibility: hidden）就等于“静音”，这是错的。隐藏控件 ≠ 静音，也不影响音频是否播放。iOS Safari 甚至会因 display: none 直接拒绝播放，哪怕写了 muted autoplay。
真正的全站静音，是指所有 <audio> 元素默认处于静音状态，并且不主动触发播放。这需要两步：一是确保所有音频标签初始即 muted；二是避免任何脚本在无用户交互时调用 play()。
立即学习“前端免费学习笔记（深入）”；
- 不要用 CSS 隐藏
<audio>元素本身，应保留为position: absolute; width: 1px; height: 1px; overflow: hidden;这类不影响布局又可被浏览器识别的方式 - WordPress 等 CMS 可通过
wp_footer注入脚本，遍历并强制设video.muted = true和audio.muted = true，但该操作仅对未播放过的音频有效 - 若页面已有多个
<audio>，建议统一用preload="metadata"而非preload="auto"，减少后台解码开销
全局开关需用localStorage + 用户交互触发
纯静音不是目的，用户得能“开声音”。所谓“全局开关”，本质是一个状态同步机制：点击一次按钮，把 muted = false 应用到所有音频，并记录到 localStorage，后续加载的音频也读取该状态。
关键约束是：只有用户点击后，才能安全调用 play() 并解除静音。所以不能一上来就 audio.muted = false; audio.play()，而要等第一次点击后，再批量恢复。
- 首次点击按钮时，执行
audio.muted = false+audio.play().catch(...)，捕获NotAllowedError是正常行为 - 用
localStorage.setItem('audioUnmuted', 'true')记录状态，后续页面加载时读取并初始化所有音频的muted属性 - 注意 iOS Safari 对
<audio>的 DOM 位置要求：必须是<body>的直系子元素，否则即使muted也无效
Vue/React项目里别用ref直接调play()
在 Vue 中写 this.$refs.audioEl.play()，或 React 中用 useRef 拿到 audio 元素再调 play()，很容易踩坑：组件挂载时还没用户交互，Promise 必 reject。
更稳妥的做法是把播放逻辑收口到一个「音频上下文管理器」里，首次交互（比如点击通知按钮、切换 tab、播放视频）时初始化，之后所有提示音都复用这个已激活的上下文。
- 不要在
mounted/useEffect(() => {}, [])里调play() - Vue 可封装
useAudioManager()composable，内部用ref存 audio 实例，暴露playAlert()方法，内部判断是否已激活 - React 推荐用
AudioContext+decodeAudioData预加载音频 buffer，比反复创建Audio实例延迟更低、兼容性更好
muted 的声明时机——它必须出现在初始 HTML 字符串里，不能靠 innerHTML 或框架渲染插入。否则哪怕结构完全一样，也会被 Safari 当作“非用户驱动”资源拒绝处理。 
