标签必须嵌套在内才有效,仅作为子元素提供多格式音源供浏览器选择,不可独立使用或与src属性混用;正确顺序为mp3→ogg→wav,需添加controls属性启用播放控件,并用fallback文本和error事件处理加载失败。

source 标签必须嵌套在 audio 标签内才有效
<source></source> 本身不渲染任何内容,也不是独立音频加载方式。它只作为 <audio></audio> 的子元素,为浏览器提供多个可选音源,由浏览器自主选择最合适的格式加载。
常见错误是把 <source></source> 当成 <audio src="..."></audio> 的替代写法,单独用或放错位置——比如写在 <audio></audio> 外面,或和 src 属性混用,这时浏览器会忽略 <source></source> 或报解析警告。
- ✅ 正确结构:
<audio><source src="a.mp3"><source src="b.ogg"></audio></li> <li>❌ 错误结构:<code><source src="a.mp3">
(无父<audio></audio>) - ❌ 错误结构:
<audio src="a.mp3"><source src="b.ogg"></source></audio>(src属性与<source></source>并存,部分浏览器会优先用src,忽略<source></source>)
不同格式的 source 要按浏览器兼容性顺序排列
浏览器按 <source></source> 出现顺序依次尝试加载,遇到第一个能解码的就停止。所以要把兼容性最广、解码开销最低的格式放在前面。
实际建议顺序:mp3 → ogg → wav。其中 mp3 在所有现代浏览器中都支持;ogg(通常是 opus 或 vorbis 编码)在 Firefox/Chrome 支持好但 Safari 不支持;wav 兼容性最差、体积最大,仅作兜底。
立即学习“前端免费学习笔记(深入)”;
- 不要把
wav放第一位——页面会卡顿,且 Safari 可能直接失败 - 不必强求覆盖所有格式:如果只提供
mp3,已覆盖 99% 场景;加ogg主要是为开源浏览器用户提供更小体积和更好音质 - 可以用
type属性显式声明 MIME 类型,例如<source src="a.mp3" type="audio/mpeg"></source>,有助于浏览器跳过不支持类型的探测
audio 标签必须有 controls 属性才能让用户播放
<audio></audio> 默认是静默、不可交互的。即使 <source></source> 加载成功,没加 controls 就看不到播放按钮、进度条或音量控件,用户无法触发播放。
常见误区是以为“只要资源能加载,JS 就能自动 play()”,但现代浏览器对自动播放限制极严(尤其含声音的),没有用户手势(如 click/tap)触发,play() 会直接 rejected。
- ✅ 必须写:
<audio controls><source src="a.mp3"></source></audio> - ✅ 若需 JS 控制,也要先确保有
controls或至少一个用户交互事件绑定,再调audio.play() - ⚠️ 注意:
muted属性可绕过部分自动播放限制,但仅适用于静音场景,不解决有声播放的权限问题
加载失败时靠 fallback 文本和 JS 监听 error 事件定位问题
<source></source> 没有内置错误提示机制。当所有 <source></source> 都加载失败,<audio></audio> 会显示空白控件(或完全不渲染),用户无法得知原因。
两个实用手段:
- 在
<audio></audio>内部末尾添加纯文本 fallback,例如:<p>您的浏览器不支持该音频格式</p>—— 这段文字只有在所有音源都不可用时才可见 - 用 JS 监听
error事件:audio.addEventListener('error', () => console.log('audio load failed')),配合检查audio.networkState和audio.error.code(如4表示 MEDIA_ERR_SRC_NOT_SUPPORTED) - 注意:Safari 对本地文件(
file://协议)的<source></source>加载常静默失败,开发阶段务必用本地服务器(如python3 -m http.server)测试
<source></source> 的“顺序敏感性”和“上下文依赖性”——它既不是独立标签,也不具备容错重试逻辑,全靠开发者预判浏览器行为。一旦路径写错、MIME 不匹配、或顺序颠倒,问题往往表现为“无声”而非报错,排查起来比 JS 报错更隐蔽。



















