VS Code editor.wordWrapColumn 怎样设置固定换行宽度

在 VS Code 里，想让长行按固定列数软换行，关键是同时设置 editor.wordWrap 和 editor.wordWrapColumn：前者决定是否采用按列换行，后者决定列数。最小配置是把 editor.wordWrap 设为 wordWrapColumn，再把 editor.wordWrapColumn 设为需要的数字，例如 80。

官方地址：https://code.visualstudio.com/

这里的“软换行”只改变编辑器中的显示方式，不会在文件里插入换行符，也不会替代 Prettier、ESLint 等格式化工具。本文只处理 VS Code 编辑器的显示设置；图片均为原创操作说明图，不是实际软件截图。

1. 先分清三个设置项的作用

editor.wordWrap 是开关和策略。设为 off 时不软换行，设为 on 时按编辑器视口宽度换行，设为 wordWrapColumn 时按 editor.wordWrapColumn 指定的列换行，设为 bounded 时取视口宽度与固定列宽两者中较小的值。

editor.wordWrapColumn 只有在 wordWrap 为 wordWrapColumn 或 bounded 时才会参与决定折行位置。它控制的是显示列，不是把源码改写成固定长度的物理行。把它改成 100，并不会自动格式化已有文件。

2. 从设置入口打开正确的 settings.json

如果希望所有项目使用同一套换行规则，打开命令面板，执行 Preferences: Open User Settings (JSON)。如果只想让当前项目采用固定列宽，执行 Preferences: Open Workspace Settings (JSON)，配置会保存到项目的 .vscode/settings.json 中。

用户设置适合个人阅读习惯，工作区设置适合团队约定或某个仓库的展示要求。两者都能生效时，工作区设置会覆盖同名的用户设置，所以排查时先确认当前编辑器打开的是 User 还是 Workspace 标签页。

下面是一个严格有效的 JSON 示例。字段含义是：editor.wordWrap 选择固定列策略，editor.wordWrapColumn 把折行列设为 80，editor.wrappingIndent 只控制视觉上的折行缩进。

{
  "editor.wordWrap": "wordWrapColumn",
  "editor.wordWrapColumn": 80,
  "editor.wrappingIndent": "same"
}

JSON 配置块不能写注释；如果要改成 100 或 120，只修改数字即可。保存后回到编辑器，找一行明显超过列宽的文本观察显示是否折行。

3. 按项目需要选择固定列宽

80 列适合窄窗口和并排阅读，100 或 120 列适合宽屏和日志阅读。固定列宽不是越小越好：列数过小会让长句在阅读时频繁折行，列数过大又可能让窄窗口横向滚动。

如果团队只希望 Markdown 文档按固定宽度显示，可以在工作区设置中写入全局规则，再结合语言特定设置只对某一种语言覆盖。例如，下面的结构把 Markdown 单独设为 100 列；严格 JSON 不插入注释，字段作用在代码块后的文字中说明。

{
  "editor.wordWrap": "off",
  "[markdown]": {
    "editor.wordWrap": "wordWrapColumn",
    "editor.wordWrapColumn": 100
  }
}

顶层的 off 表示其他语言默认不强制软换行；[markdown] 是语言特定设置作用域；嵌套的两个字段只影响 Markdown 编辑器。若希望所有语言统一固定列宽，就把两个字段放在顶层，不要再套语言作用域。

4. 用 bounded 看清视口和固定列的差异

wordWrapColumn 会把折行目标固定在设置的列数附近；bounded 则会在窗口很窄时优先服从视口，避免折行点落在编辑器可视区域之外。它适合经常调整窗口大小、需要兼顾固定阅读宽度和窄屏适应性的场景。

例如设置列宽为 100：窗口足够宽时，bounded 会接近 100 列折行；窗口缩窄到 70 列时，它会按较小的视口宽度折行。若你要求无论窗口如何变化都尽量按 100 列展示，应选择 wordWrapColumn，而不是 bounded。

5. 配置不生效时按可见状态排查

第一步看当前值：打开设置编辑器，搜索 word wrap，确认 Editor: Word Wrap 不是 off。如果它是 on，编辑器会按视口折行，此时单独修改 wordWrapColumn 看不到预期效果。

第二步看作用域：在设置编辑器顶部切换 User 和 Workspace，确认没有更具体的工作区或语言设置覆盖了你的值。对 Markdown、JSON、Go 等文件，语言特定设置可能比全局设置更接近当前文件。

第三步看现象边界：软换行不会在磁盘文件中新增换行符，也不会改变 Git diff 中的真实行结构。如果你需要提交前把源码真正整理到某个长度，应单独配置格式化器或手动编辑；不要把“屏幕上折行”当成“文件内容已换行”。

第四步看文件类型：有些编辑器视图或特殊文本预览可能有自己的显示行为。先用普通文本文件做对照，再回到目标文件，避免把语言服务、格式化扩展或预览组件的问题误认为 wordWrap 配置错误。

6. 最后用这张速查表确认设置

可以按下面的组合快速判断：想固定列宽，就用 wordWrapColumn；想让窄窗口自动收紧，就用 bounded；想只影响当前仓库，就写入 Workspace Settings；想所有项目默认使用，就写入 User Settings。

如果设置保存后仍看不到差异，优先检查策略值、作用域和当前文件类型这三个可见条件。确认配置生效后，再决定是否需要额外的格式化器；两者解决的是不同问题。

常见问题

改了 wordWrapColumn，为什么没有变化？

通常是 editor.wordWrap 仍为 on 或 off。只有 wordWrapColumn 和 bounded 会使用这个列数。

软换行会修改文件内容吗？

不会。它只改变编辑器的显示布局，不会自动写入换行符，也不会改变保存后的文件行结构。

应该放 User Settings 还是 Workspace Settings？

个人习惯放 User Settings；项目协作要求放 Workspace Settings。若两处都有同名配置，当前工作区或语言特定设置可能覆盖用户设置。

官方操作说明：https://code.visualstudio.com/docs/editing/codebasics