Audio Preview 扩展可实现在 VSCode 中内嵌播放音频文件。需先安装扩展，再通过双击文件、命令面板或配置支持格式来启用预览，还可禁用自动播放以优化性能。
如果您在 Visual Studio Code 中打开了音频文件，但无法直接预览播放，则可能是由于缺少必要的扩展或配置未启用。以下是启用并使用 Audio Preview 功能的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Audio Preview 扩展
VSCode 默认不支持音频文件内嵌播放，需通过第三方扩展实现该功能。Audio Preview 是一个轻量、开源且广泛使用的扩展，可直接在编辑器侧边栏或内联区域播放常见音频格式。
1、打开 VSCode，点击左侧活动栏中的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 Audio Preview。
3、在搜索结果中找到作者为 robmurray 的扩展，确认其名称为 Audio Preview 且已获得高评分与大量安装量。
4、点击“安装”按钮，等待安装完成，然后点击“重新加载”以激活扩展。
二、直接点击音频文件触发预览
扩展启用后，VSCode 会自动为支持的音频文件（如 .mp3、.wav、.ogg、.flac）注册预览行为。双击文件即可在编辑器中启动播放界面，无需切换到外部播放器。
1、在资源管理器中找到任意一个音频文件（例如 sample.mp3）。
2、双击该文件，编辑器中央将显示一个带播放控件的内联预览面板。
3、面板中包含播放/暂停、进度条、音量滑块及当前播放时间，所有操作均在编辑器上下文中完成。
三、使用命令面板手动触发预览
当文件未被自动识别或处于非标准路径时，可通过命令面板强制调用 Audio Preview 功能，确保兼容性覆盖更广的文件场景。
1、按下快捷键 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）打开命令面板。
2、输入 Audio Preview: Play 并回车。
3、若当前编辑器中已打开音频文件，将立即启动预览；否则系统会提示选择目标音频文件。
四、配置支持的音频文件类型
默认情况下，Audio Preview 仅关联部分常见后缀。如需支持自定义格式（如 .m4a 或 .aac），需手动修改 VSCode 设置，扩展其识别范围。
1、打开设置界面（快捷键 Cmd+, ）。
2、在搜索框中输入 audioPreview.supportedTypes。
3、点击“在 settings.json 中编辑”，在数组中添加所需后缀，例如："m4a", "aac"。
4、保存文件，重启 VSCode 使配置生效。
五、禁用自动预览以节省资源
对于含大量音频文件的项目，自动预览可能引发不必要的资源占用。可通过关闭自动触发机制，在需要时才手动播放，提升编辑器响应效率。
1、打开设置界面，搜索 audioPreview.autoPlay。
2、取消勾选该选项，或在 settings.json 中将其设为 false。
3、此后双击音频文件将仅打开文本/二进制视图，播放需通过命令面板或右键菜单显式调用。
