如何在 Visual Studio Code 中开启和设置自动换行
创建时间 2026-11-23
最后修改 2026-11-23
在 Visual Studio Code 的当前文本编辑器中,按 Alt+Z(macOS 为 ⌥+Z)即可打开或关闭自动换行。要保存这一偏好,请在设置中修改 editor.wordWrap。
在当前编辑器中切换自动换行
先让目标文本编辑器获得焦点,然后再次按同一快捷键即可切换状态。也可以打开命令面板,执行 View: Toggle Word Wrap 或相应的本地化命令。
该命令会改变当前编辑器的显示方式。一行较长的文本可以分成多行显示,原来的行号和文件内容保持不变。
保存自动换行设置
- 按 Ctrl+,(macOS 为 ⌘+,)打开设置。
- 搜索
@id:editor.wordWrap。 - 选择
on,使文本按编辑器的可用宽度换行。如需设置列数上限,可从下表选择相应模式。
在 User(用户)选项卡中修改的设置会保存到当前配置文件。打开工作区后,可以在 Workspace(工作区)选项卡中为当前项目设置。
四种自动换行模式
| 设置值 | 行为 |
|---|---|
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 修改过设置,请在原来的作用范围内删除相应属性。




