如何在 Visual Studio Code 中开启和设置自动换行

在 Visual Studio Code 的当前文本编辑器中,按 Alt+Z(macOS 为 ⌥+Z)即可打开或关闭自动换行。要保存这一偏好,请在设置中修改 editor.wordWrap。

在当前编辑器中切换自动换行

先让目标文本编辑器获得焦点,然后再次按同一快捷键即可切换状态。也可以打开命令面板,执行 View: Toggle Word Wrap 或相应的本地化命令。

该命令会改变当前编辑器的显示方式。一行较长的文本可以分成多行显示,原来的行号和文件内容保持不变。

VS Code 官方自动换行说明

保存自动换行设置

  1. 按 Ctrl+,(macOS 为 ⌘+,)打开设置。
  2. 搜索 @id:editor.wordWrap。
  3. 选择 on,使文本按编辑器的可用宽度换行。如需设置列数上限,可从下表选择相应模式。

在 User(用户)选项卡中修改的设置会保存到当前配置文件。打开工作区后,可以在 Workspace(工作区)选项卡中为当前项目设置。

VS Code 官方设置优先级说明

四种自动换行模式

设置值 行为
off 关闭自动换行。可以横向滚动查看长行。这是默认值。
on 根据编辑器的可用宽度换行。
wordWrapColumn 按 editor.wordWrapColumn 指定的列换行,该值默认为 80。
bounded 在编辑器可用宽度和设定列数中取较小的限制。

如需在指定列显示竖直参考线,可以使用 editor.rulers。文本的换行位置仍由所选的自动换行模式决定。

将换行上限设为 88 列

在命令面板中执行 Preferences: Open User Settings (JSON) 以编辑用户设置。若已有其他设置,请将以下两个属性加入现有 JSON 对象,并用逗号分隔各个属性。

{
  "editor.wordWrap": "bounded",
  "editor.wordWrapColumn": 88
}

打开一个含有长行的文件,再缩窄编辑器。当可用宽度小于 88 列时,文本会提前换行。单词边界和制表符的显示宽度可能影响实际换行的位置。

检查和重置设置

如果不同文件的显示效果有差异,请检查工作区设置及 [markdown] 等按语言设置的选项。如果只有一个编辑器的表现不同,可以用 Alt+Z 或 ⌥+Z 切换该编辑器的临时状态。

要重置设置,请打开对应设置项的齿轮菜单并选择 Reset Setting。如果通过 JSON 修改过设置,请在原来的作用范围内删除相应属性。