VS Code 怎样只对 Markdown 文件开启自动换行

如果只想让 Markdown 文档的长行自动折行，不必把 VS Code 的全局 editor.wordWrap 改成 on。更稳妥的做法是写入 Markdown 的语言专属设置：[markdown] 代码块中的 "editor.wordWrap": "on"。这样 Markdown 会自动换行，Go、JSON 等其它语言仍按各自设置显示。

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

最短路径是打开设置编辑器，搜索 @lang:markdown，找到 Editor: Word Wrap 并把范围设为 User 或 Workspace；如果用 JSON 配置，就在对应的 [markdown] 块中写入 "editor.wordWrap": "on"。

先分清全局换行和 Markdown 专属换行

editor.wordWrap 是编辑器的换行策略。把它直接写在最外层，会影响所有语言；把它放在 [markdown] 块中，只对 Markdown 语言模式生效。本文只处理后者，避免为了解决 Markdown 阅读体验而改变代码文件的默认布局。

还要注意，语言专属设置不是对文件名后缀的简单字符串匹配，而是依据 VS Code 当前的语言模式。一个扩展名异常或语言模式被误选为 Plain Text 时，配置看起来正确，文件仍可能不折行。

通过设置编辑器筛选 Markdown

打开一个 Markdown 文件，按 Cmd/Ctrl+, 进入设置编辑器。在顶部搜索框输入 @lang:markdown，再搜索 word wrap。结果应聚焦到 Markdown 语言范围内的 Editor: Word Wrap 设置。

如果当前打开的不是 Markdown 文件，也可以直接在搜索框使用 @lang:markdown；它表达的是目标语言，而不是当前活动文件。找到设置后，点击下拉框选择 on。

设置编辑器中的值只是一个入口，关键是它被写入哪个范围。选择 User 会让当前用户的 VS Code 实例普遍生效；选择 Workspace 则只对当前项目生效。

在 Markdown 语言块中开启自动换行

如果希望配置可读、可提交，直接编辑 settings JSON 也很清楚。打开命令面板，执行 Preferences: Open User Settings (JSON) 或 Preferences: Open Workspace Settings (JSON)，加入下面的 JSONC 配置：

{
  // 只给 Markdown 开启自动换行，不改变其它语言
  "[markdown]": {
    // on 表示按编辑器宽度显示折行
    "editor.wordWrap": "on"
  }
}

settings.json 支持 JSONC，所以可以保留注释。若文件里已经有 [markdown] 块，只需在同一个块内补上 editor.wordWrap，不要重复创建同名对象。on 是按编辑器宽度折行；它不会在 Markdown 文件中插入真实换行符。

也可以从当前文件右下角的语言模式入口进入：点击状态栏中的语言标识，选择配置该语言的设置，VS Code 会打开相应的语言专属设置位置。这个入口适合不确定语言 ID 的情况。

选择 User 还是 Workspace

如果这是团队仓库的文档约定，建议使用 Workspace 范围并检查 .vscode/settings.json 是否应纳入版本控制。不要为了共享一条换行设置而提交包含个人路径、账号或其它本机偏好的完整配置。

{
  // 项目级设置只影响打开这个工作区的成员
  "[markdown]": {
    // 让仓库中的 Markdown 长行按编辑器宽度折行
    "editor.wordWrap": "on"
  }
}

验证优先级并排查不生效

打开一个较长的 Markdown 段落，确认长行在编辑器宽度处折行；再打开 Go 或 JSON 文件做对照。如果只有 Markdown 折行，说明语言专属设置起效。下面这张原创结果示意图把折行状态和配置块放在一起，便于理解两者的对应关系。

1. 检查语言模式：看状态栏是否显示 Markdown。若显示 Plain Text，先切换语言模式，再判断设置是否生效。
2. 检查配置位置：确认 editor.wordWrap 在 [markdown] 对象内，而不是误放在 JSONC 的最外层。
3. 检查作用域：工作区设置会覆盖用户设置；同一语言的 Workspace 配置可能覆盖 User 配置。打开设置编辑器的作用域切换，确认修改落在哪一层。
4. 检查多个语言块：如果使用了类似 [markdown][yaml] 的组合块，先确认它没有和单独的 [markdown] 块产生意外覆盖；排查时保留单语言块最直观。
5. 检查折行值：off、on 和 wordWrapColumn 的效果不同。本文目标是随编辑器宽度折行，因此应选择 on。

速查表

相关问题

Markdown 自动换行会修改文件内容吗？

不会。editor.wordWrap只改变编辑器的显示方式，不会在 Markdown 文件中插入换行符。

为什么设置了 Markdown 仍然不折行？

先确认状态栏语言模式是 Markdown，再检查配置是否位于 [markdown] 块内，以及当前窗口是否打开了包含该 Workspace 设置的项目。

能不能只对某个项目的 Markdown 文件开启自动换行？

可以。把同样的语言块写入该项目的 .vscode/settings.json，并选择 Workspace 范围即可。