Visual Studio Code / 如何关闭音效
要关闭 Visual Studio Code(VS Code)内置的辅助功能提示音,可以在用户设置中将 accessibility.signalOptions.volume 设为 0。该设置控制移动到错误行等事件对应的信号音;如果声音由扩展自行播放,可能还需要调整该扩展的设置。
在设置界面中关闭音效
辅助功能信号通过声音等方式提示错误、警告和断点等状态。降低信号音量不会关闭屏幕阅读器的所有语音播报,因此需要区分提示音和朗读功能。
- 在 Windows 或 Linux 中按 Ctrl + ,,在 macOS 中按 Command + ,,打开设置。
- 在搜索框下方选择用户(User)。用户设置适用于使用当前配置文件打开的各个项目;工作区(Workspace)设置适用于当前项目。
- 搜索
accessibility.signalOptions.volume。 - 将 Accessibility › Signal Options: Volume 的值改为 0。界面中的名称可能经过翻译,但搜索所用的设置键在各语言界面中相同。
如果找不到“用户”选项卡,可以按 F1 打开命令面板,执行 Preferences: Open User Settings (UI),直接进入用户设置。这里的选项卡用于选择设置的生效范围,并不是代码编辑区上方的文件标签页。
再次执行之前会发出声音的操作,确认效果。要恢复声音,可以将音量改为大于0的值,或在该设置的齿轮菜单中选择重置设置(Reset Setting)。音量范围为0~100,默认值可以查看 VS Code 官方设置定义。
在 settings.json 中关闭音效
也可以直接编辑用户配置文件。JSON 是一种用名称和值记录设置的文本格式。命令面板还可通过 Windows、Linux 的 Ctrl + Shift + P 或 macOS 的 Command + Shift + P 打开。
- 执行
Preferences: Open User Settings (JSON)。应打开可以编辑的用户设置文件,而不是只读的默认设置。 - 在原有最外层
{ }内添加"accessibility.signalOptions.volume": 0。如果已有相同的键,修改原来的值,不要重复添加。 - 保存文件,再次执行之前会发出声音的操作。
如果设置文件为空,下面是完整示例:
{
"accessibility.signalOptions.volume": 0
}
如果文件中已有其他设置,请保留原内容,不要用上面的示例替换整个文件。例如,保留原有字体大小并加入音量设置时,需要用逗号分隔两个属性:
{
"editor.fontSize": 16,
"accessibility.signalOptions.volume": 0
}
editor.fontSize 只是用来演示如何保留已有设置,不需要额外添加。注意不要再套一层最外层花括号,也不要漏掉属性之间的逗号。要撤销修改,只删除音量属性或将其恢复为原值,保留其他设置。关于生效范围与优先级,可参阅官方用户设置与工作区设置指南。
只关闭特定音效
如果希望保留有用的声音,可以单独配置各个辅助功能信号。先将总音量恢复为大于0的值;总音量为0时,即使单独启用某个信号,也听不到它的声音。
- 按 F1 打开命令面板。
- 执行
Help: List Signal Sounds。 - 找到对应的信号并禁用它的声音。在列表中切换条目时,可以试听各个声音。
也可以在设置界面搜索 accessibility.signals,关闭对应的 Sound 选项。如果旁边还有播报选项,应将语音播报和音效区分开。auto 表示满足条件时启用,并不等于完全关闭;例如检测到屏幕阅读器时,信号音可能会启用。相关行为与列表命令见官方辅助功能信号指南。
设置后仍有声音时如何排查
先确定声音出现的时机,例如移动到错误行、在终端运行命令,或扩展完成任务。这些情况可能来自不同的声音来源。
- 检查工作区设置。 项目中单独设置的值可能覆盖用户设置。查看设置界面的 Workspace 范围,以及项目中的
.vscode/settings.json是否包含相同的键。如果使用多根工作区或远程环境,还应检查相关文件夹或远程范围的设置。 - 检查当前配置文件。 如果切换过配置文件,请重新打开当前配置文件的用户设置。修改一个配置文件,不代表其他所有配置文件都会自动采用相同的值。
- 检查扩展。 如果只有使用某个扩展时才有声音,可以在该扩展的设置中搜索
sound、audio或notification。必要时暂时禁用可疑扩展,对比相同操作的结果,检查结束后再启用。 - 检查终端中运行的程序。 将辅助功能信号静音,不一定会阻止其他程序直接播放音频。需要查看该程序自己的声音或通知选项。
还要确认保存的音量确实为0,并且设置文件没有语法错误。如果只是想关闭声音,调整音量或特定信号的声音设置,有助于保留其他需要的辅助功能。