audio标签src必须用相对路径,如"audio/bgm.mp3",以HTML文件所在目录为基准;file://协议在本地双击打开时被浏览器禁止,需配合controls属性才能显示控件并播放。

audio 标签 src 属性必须用相对路径,不能用 file://
浏览器出于安全限制,直接双击打开 HTML 文件时,<audio></audio> 的 src 值若写成 file:///D:/music.mp3 或 file://./music.mp3,基本都会静音或报错(如 DOMException: The element has no supported sources)。唯一可靠的方式是让 src 指向相对于 HTML 文件位置的路径。
比如你的文件结构是:
project/
├── index.html
└── audio/
└── bgm.mp3
那么在 index.html 里就得写:
<audio controls> <source src="audio/bgm.mp3" type="audio/mpeg"> </audio>
-
src值"audio/bgm.mp3"是从index.html所在目录出发的相对路径 - 不要加
./前缀(虽然多数情况也行,但冗余且部分旧环境不稳) - 路径区分大小写,Windows 下常忽略,但部署到 Linux 服务器就会出问题
常见相对路径错误写法与现象
这些写法在本地双击打开时大概率失效:
立即学习“前端免费学习笔记(深入)”;
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
-
src="D:/project/audio/bgm.mp3"→ 浏览器拒绝加载,控制台报Not allowed to load local resource -
src="file://audio/bgm.mp3"→ 路径协议错误,解析失败 -
src="../audio/bgm.mp3"→ 只有当 HTML 不在项目根目录(比如在project/page/index.html)时才需要,否则越级跳转导致 404 -
src="audio\bgm.mp3"→ Windows 风格反斜杠,HTML 规范只认正斜杠/,部分浏览器会静默失败
如何快速验证路径是否写对
别靠猜,直接用浏览器开发者工具确认:
- 右键页面 → “检查” → 切到
Network标签页 - 刷新页面,找
bgm.mp3这类请求 - 如果状态码是
200,说明路径正确;如果是404,点开看它实际请求的 URL,对比你写的src和 HTML 文件位置,就能反推出该填什么 - 也可以把
src值复制出来,粘贴到浏览器地址栏(保持当前 HTML 所在目录为基准),看能否直接下载音频
audio 标签必须加 controls 或 JS 控制,否则不显示也不播放
仅写 <audio src="audio/bgm.mp3"></audio> 是不可见、不自动播放、也无法手动触发的。必须显式启用交互能力:
- 加
controls属性:用户可见播放控件,最简单 - 加
autoplay muted(注意:无muted会被浏览器拦截) - 用 JS 调用
play(),但需用户手势触发(如点击按钮),否则抛NotAllowedError
所以稳妥起步写法就是:
<audio controls src="audio/bgm.mp3"> Your browser does not support the audio element. </audio>
相对路径本身不难,难的是路径基准容易被忽略——它永远以 HTML 文件所在目录为起点,不是以当前编辑器打开的文件夹,也不是以终端运行位置为准。


















