audio标签必须同时具备src和controls才真正可用；src路径须为相对或HTTPS URL，服务器需返回正确Content-Type，且必须用<source>提供MP3+OGG双格式并声明type，autoplay须配muted且受用户交互限制。

audio 标签必须带 src 和 controls 才能真正可用，缺一不可——不写 controls 就等于没放控件，用户点不了、看不见、没法操作。

为什么写了 audio 却“没反应”

常见现象是页面加载后音频区域空白或只显示一个灰色横条。根本原因通常是：

• src 路径错误：用的是 file:/// 或绝对本地路径（如 C:\music.mp3），浏览器直接拒绝加载；应改用相对路径（如 ./audio/song.mp3）或 HTTPS URL
• 服务器未返回正确 MIME 类型：MP3 文件需响应头含 Content-Type: audio/mpeg，否则 Chrome/Safari 可能静默失败；Python 的 http.server 或 GitHub Pages 默认不设，得手动配或换服务
• 控制台报 404 或 ERR_FAILED：检查 Network 面板里音频请求的状态码和响应头，不是代码错了，是资源没到位

多格式兼容必须用 source + 正确 type

只放一个 .mp3 文件，在 Firefox 或旧版 Edge 上大概率白屏。浏览器按 source 顺序选第一个能解码的，但前提是 type 写对：

• type="audio/mpeg" 对应 MP3（audio/mp3 是错的，会被跳过）
• type="audio/ogg" 对应 OGG（推荐用 ffmpeg -i input.mp3 -c:a libvorbis output.ogg 转）
• 不要依赖 .wav：体积大、无压缩，现代项目基本不用

结构示例：

Html2md

使用 Readability + Turndown 将 HTML 页面转换为干净的、Agent 友好的 Markdown。去除导航栏、广告、页脚、Cookie 横幅、社交按钮等干扰元素。支持 URL...

下载

立即学习“前端免费学习笔记（深入）”；

<audio controls>
  <source src="song.mp3" type="audio/mpeg">
  <source src="song.ogg" type="audio/ogg">
  您的浏览器不支持 audio 元素。
</audio>

autoplay 必须配 muted，且移动端仍受限

加了 autoplay 却没声音？不是 bug，是浏览器策略强制拦截。Chrome、Safari、Edge 等全部要求：autoplay 和 muted 同时存在才允许启动。

• 即使加了 muted，iOS Safari 仍要求首次播放必须由用户点击触发，否则后续解除静音也会失败
• 开发时别依赖自动播放测试功能——本地双击 HTML 文件跑 file:// 协议，Chrome/Firefox 直接禁音频加载，务必起本地服务（如 python -m http.server）
• preload="metadata" 建议显式加上，避免首次 play() 因元数据未加载而卡住

最易被忽略的一点：音频是否“可用”，不取决于 HTML 写得漂不漂亮，而取决于路径可访问、MIME 正确、格式有兜底、交互时机合规——四者缺一，用户就听不到。