Audio Cues 功能需先启用全局开关,再配置终端成功/失败、断点命中等事件提示音,支持自定义WAV音效、扩展增强(如ESLint校验),并可临时禁用特定提示。

如果您在使用 VSCode 编写代码时希望获得更直观的反馈,Audio Cues 功能可通过声音提示辅助识别编辑操作、错误状态或调试事件。以下是启用与配置该功能的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、启用 Audio Cues 全局开关
Audio Cues 功能默认处于禁用状态,需手动开启全局音频提示总控,否则所有子项设置均不生效。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 audio cues。
3、找到 Audio Cues: Enabled 选项,勾选其复选框。
二、配置特定事件的声音提示
VSCode 提供多个可独立控制的音频触发点,每种对应不同开发场景,用户可根据需要单独启用或禁用。
1、在设置搜索栏中保持 audio cues 输入状态。
2、向下滚动,定位到 Audio Cues: Terminal Command Succeeded 并启用。
3、继续查找 Audio Cues: Terminal Command Failed 并启用。
4、启用 Audio Cues: On Debug Breakpoint Hit 以在断点触发时获得提示音。
三、替换系统默认音效文件
VSCode 允许用户将内置提示音替换为自定义音频文件,需确保格式为 WAV 且采样率兼容。
1、准备一个时长不超过 1.5 秒 的单声道 WAV 文件。
2、打开 VSCode 命令面板(Cmd + Shift + P),输入并选择 Preferences: Open Settings (JSON)。
3、在 settings.json 中添加如下字段:
"audioCues.builtinAudioCues": {"terminalCommandSucceeded": "/Users/YourName/sounds/success.wav"}
四、通过扩展增强 Audio Cues 行为
部分扩展可在原生 Audio Cues 基础上扩展触发条件,例如保存时校验 ESLint 后播放提示音。
1、在扩展市场中搜索并安装 Audio Cues Plus。
2、安装完成后重启 VSCode。
3、打开设置,搜索 audio cues plus,启用 Enable ESLint Result Cue。
五、禁用特定上下文中的音频输出
当处于会议或专注模式时,可临时关闭部分高频率提示音以减少干扰,而不影响核心调试提示。
1、打开命令面板(Cmd + Shift + P)。
2、输入并执行 Developer: Toggle Developer Tools。
3、在控制台中粘贴并运行以下代码:
vscode.workspace.getConfiguration('audioCues').update('onNoResultsFound', false, vscode.ConfigurationTarget.Global)










