VSCode 的 Audio Cues 功能支持启用、自定义音效、精细开关控制、系统级声音集成及重置默认设置。需通过设置或 settings.json 配置 audioCues.enabled、customSounds、useSystemSounds 等选项，并可按事件单独启停提示。
如果您在使用 VSCode 编写代码时希望借助听觉反馈快速识别编辑器状态变化，例如错误、警告、断点命中或调试暂停，则可启用并配置内置的“Audio Cues”功能。以下是实现该功能的具体操作路径与调整方式：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用 Audio Cues 基础功能
VSCode 的 Audio Cues 功能默认处于关闭状态，需手动开启才能触发声音提示。启用后，编辑器将根据预设事件播放系统音频文件，无需安装额外扩展。
1、点击左下角齿轮图标，选择设置。
2、在搜索框中输入audio cues。
3、勾选Audio Cues: Enabled复选框。
二、为特定事件分配自定义音效
VSCode 允许用户为不同开发事件单独指定音频文件，从而区分错误、断点、调试完成等状态。所选音频必须为本地 WAV 或 MP3 格式，且路径需为绝对路径。
1、在设置搜索栏中输入audio cues custom sound。
2、展开Audio Cues: Custom Sounds配置项。
3、点击Edit in settings.json链接，进入 JSON 配置界面。
4、在 "audioCues.customSounds" 对象内添加键值对，例如："debug.breakpointHit": "/Users/username/sounds/break.wav"。
三、禁用某类音频提示而不影响整体功能
当仅需保留部分提示（如仅保留错误音效）时，可通过关闭对应事件的开关实现精细控制，避免声音干扰专注力。
1、在设置中搜索audio cues error。
2、取消勾选Audio Cues: Error。
3、重复上述操作，分别关闭Warning、Debug Breakpoint Hit等对应开关。
四、切换为系统级声音方案
VSCode 提供了与操作系统原生声音机制集成的选项，启用后所有音频提示将通过系统音频服务播放，兼容外接扬声器与蓝牙音频设备。
1、打开命令面板（Cmd+Shift+P）。
2、输入并选择Preferences: Open Settings (JSON)。
3、在 settings.json 中添加配置项："audioCues.volume": 0.8与"audioCues.useSystemSounds": true。
五、重置音频提示至默认行为
若自定义配置导致声音异常或缺失，可快速恢复为 VSCode 内置音效集，确保基础提示功能可用。
1、在设置中搜索audio cues reset。
2、点击Audio Cues: Reset to Default Sounds按钮。
3、重启 VSCode 使更改生效。
