启用 VSCode 音频提示需先在设置中开启 audioCues.enabled，再按需配置 onSave、onError 等事件音效，支持自定义 WAV 文件替换及 settings.json 手动编辑，同时排查第三方扩展的干扰音效。
如果您在使用 VSCode 时希望关键操作（如保存文件、任务完成、错误触发）能通过声音即时反馈，则可能是由于“音频提示”功能未启用或音频资源未正确配置。以下是启用并自定义该功能的具体步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用音频提示基础设置
VSCode 内置的音频提示依赖于设置中的 accessibility.verbosity 和 audioCues 配置项，需手动开启对应开关以激活声音反馈机制。
1、按下 Cmd + , 打开设置界面。
2、在搜索栏输入 audio cues。
3、勾选 Audio Cues: Enabled 选项。
4、在下拉菜单中选择 On 而非 Auto 或 Off。
二、配置具体操作的声音类型
音频提示支持按事件类型独立控制，例如保存成功、断点命中、错误出现等，每类事件可单独启用或禁用对应音效。
1、在设置搜索栏输入 audioCues.onSave。
2、将 Audio Cues: On Save 设置为 on。
3、重复上述过程，分别设置 audioCues.onTerminalCommandFinished、audioCues.onDebugBreak、audioCues.onError 等项为 on。
三、替换默认音效文件
VSCode 允许用户通过覆盖内置音频资源路径的方式，使用自定义 WAV 文件替代默认提示音，所有音效必须为单声道、16 位、44.1kHz 格式。
1、访问 VSCode 安装目录下的 Contents/Resources/app/out/vs/workbench/contrib/audioCues/browser/media/（macOS）。
2、备份原始 save.wav、error.wav 等文件。
3、将准备好的同名 WAV 文件复制到该目录，确保文件权限为可读。
4、重启 VSCode 使更改生效。
四、通过 settings.json 直接编辑配置
对于高级用户，可绕过图形界面，直接修改用户设置 JSON 文件，实现更精细的音频提示控制与批量启用。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Preferences: Open Settings (JSON)。
3、在大括号内添加以下配置块：
“audioCues.enabled”: true,
“audioCues.onSave”: “on”,
“audioCues.onError”: “on”,
“audioCues.onDebugBreak”: “on”
五、禁用特定扩展引发的干扰音效
部分第三方扩展（如 Live Server、Error Lens）会自行注入音频事件，导致与原生音频提示冲突或重复发声，需排查并关闭其独立音效开关。
1、点击左侧活动栏的 扩展图标 （四个方块组成的图标）。
2、在搜索框中输入扩展名称，例如 Error Lens。
3、点击扩展右侧的齿轮图标，选择 Extension Settings。
4、查找含 sound、audio 或 notification 的设置项。
5、将其值设为 false 或 off。
