vs code音频预览插件(audio-preview)直接支持.wav、.mp3、.ogg、.flac、.aac、.opus、.m4a、.sph格式,不支持.aiff和.wma;其解码能力受限于chromium内核,与chrome一致。

vscode-audio-preview 能直接播放哪些格式
它支持的不是“所有常见音频”,而是有明确范围的解码能力:.wav、.mp3、.ogg、.flac、.aac、.opus、.m4a、.sph。注意 .aiff 和 .wma 不在默认支持列表里,强行打开会静音或报错 Unsupported audio type。浏览器 Web Audio API 的限制决定了它无法绕过这一层——VS Code 底层复用的是 Chromium 的音频解码器,所以和 Chrome 能播什么基本一致。
为什么双击 .mp3 没反应,但右键 “Audio Preview: Play” 可以
这是插件的自动激活策略导致的。默认情况下,audioPreview.autoPlay 是 false,且插件只对显式触发(如右键菜单、命令面板调用)响应,不会监听资源管理器里的双击事件。除非你在 settings.json 里加了这行:
"audioPreview.autoPlay": true
但即使开了这个,也只对已知扩展名生效;如果文件没后缀、或后缀被误标为 .dat,依然不会启动预览。
波形图不显示或严重失真怎么办
常见原因有三个:
-
WavPreview.autoAnalyze默认是false,必须手动开启,否则只播放不绘图 - 大文件(比如 >100MB 的未压缩 WAV)可能触发内存限制,导致分析中途失败,控制台报
RangeError: Array buffer allocation failed - 采样率过高(如 384kHz)或位深异常(如 32-bit float 无符号)时,插件解析逻辑会跳过波形计算,只显示空白区域
临时验证方法:用 sox input.wav -r 44100 -b 16 output.wav 重采样后再试。
和 Multimodal Preview 插件冲突吗
会。两者都注册了对 .wav 和 .mp3 的 customEditor 处理器,VS Code 只允许一个插件接管同一种文件类型的内联编辑器。优先级取决于安装顺序和插件 manifest 中的 contributes.customEditors 权重,但实际中往往后者覆盖前者。如果你发现点击音频文件弹出“无法加载自定义编辑器”,大概率是另一个多模态插件占用了入口。解决办法是禁用其中一个,或在 settings.json 中强制指定:
"workbench.editorAssociations": { "*.wav": "vscode-audio-preview.audioPreviewEditor" }
这个配置容易被忽略,但它才是决定“谁来真正打开文件”的开关。











