工具Visual Studio Code 使用指南

快速临时切换（当前文件生效）

适合临时编辑单个文件时使用，无需进入设置界面，切换即时生效：

1. 快捷键切换（最推荐）：
   • Windows/Linux：按下 Alt + Z
   • macOS：按下 Option + Z 按一次开启自动换行，再按一次关闭，状态栏会显示当前状态（开启时会出现”Wrap”标识）。
2. 菜单栏快速操作： 点击顶部菜单栏「View（视图）」→ 勾选「Word Wrap（自动换行）」，再次点击可取消。
3. 右下角图标切换： 点击编辑器右下角（行号与滚动条之间）的”换行符号”图标，点击后直接开启自动换行，直观便捷。

全局永久设置（所有文件生效）

希望所有文件默认自动换行时，可通过设置面板配置，一次设置长期生效：

1. 打开设置界面：
   • 快捷键：Windows/Linux 按 Ctrl + ,，macOS 按 Cmd + ,
   • 图形化操作：点击左下角齿轮图标 → 选择「设置」。
2. 搜索并配置核心选项： 在设置搜索框中输入 word wrap，找到「Editor: Word Wrap」（编辑器：自动换行）选项，选择以下模式之一：
   • on：强制所有文件始终自动换行，不受窗口宽度影响；
   • auto：默认模式，根据编辑器窗口宽度动态换行（窗口缩小则换行，放大则恢复）；
   • bounded：仅当内容宽度超过编辑器视口时换行，兼顾宽屏显示和长行处理；
   • wordWrapColumn：按指定列数换行（需配合下方「Editor: Word Wrap Column」设置）。
3. 可选：自定义换行列数（精准控制）： 若选择 wordWrapColumn 模式，继续搜索 word wrap column，找到「Editor: Word Wrap Column」，输入具体数值（如 80 或 120），表示每行达到该字符数时自动换行（设置为 0 则无列数限制）。 示例：设置为 80 时，代码行超过 80 个字符会自动折行，适合遵循代码规范的场景。

高级配置（按文件类型定制/修改配置文件）

适合需要对不同文件类型（如 Markdown 自动换行、JSON 不换行）单独设置的场景：

1. 按文件类型差异化配置：

   1. 打开设置界面（Ctrl + , / Cmd + ,）；

   2. 点击右上角「打开设置（JSON）」（图标为 {}），在 settings.json 中添加以下格式配置（示例）：

      {
        // 对 Markdown 文件强制自动换行
        "[markdown]": {
          "editor.wordWrap": "on"
        },
        // 对纯文本文件按 100 列换行
        "[plaintext]": {
          "editor.wordWrap": "wordWrapColumn",
          "editor.wordWrapColumn": 100
        },
        // 对 JSON 文件禁用自动换行
        "[json]": {
          "editor.wordWrap": "off"
        }
      }

      保存后，不同类型文件会自动应用对应的换行规则。

2. 直接修改 settings.json（高级用户）：

   1. 打开命令面板：Windows/Linux 按 Ctrl + Shift + P，macOS 按 Cmd + Shift + P；

   2. 输入 Preferences: Open User Settings (JSON) 并选择，直接在文件中添加核心配置：

      {
        "editor.wordWrap": "on", // 全局默认开启
        "editor.wordWrapColumn": 120 // 全局默认 120 列换行
      }

      适合习惯手动编写配置的用户，修改后即时生效。

常见问题排查（自动换行未生效）

若按上述方法设置后仍不生效，可检查以下原因：

1. 文件类型关联覆盖：部分文件类型（如 JSON、日志文件）可能有单独配置，需在 settings.json 中排查是否存在冲突配置；
2. 扩展冲突：禁用近期安装的代码格式化、美化类扩展（如某些代码规范插件），这类扩展可能修改编辑器换行行为；
3. 配置文件语法错误：检查 settings.json 是否有缺少逗号、引号不匹配等语法错误，错误会导致配置失效；
4. 编码问题：极少数情况下，文件编码非 UTF-8 可能影响换行，可将文件另存为 UTF-8 编码后重试。

关键说明

VS Code 的自动换行仅为「视觉软换行」，不会修改文件实际内容（不会添加真实换行符），保存后文件的原始格式不变，仅在编辑器中优化显示效果，避免水平滚动，提升长行代码/文本的可读性。