macOS 如何在 VS Code 中配置代码折行设置防止长文本超出屏幕

在 macOS 的 VS Code 中需手动启用 editor.wordWrap 实现自动折行：快捷键 Option + Z 临时切换，或设为 "on" 永久生效；配合 "editor.wrappingIndent": "indent" 修复缩进错位，并检查语言专属设置是否覆盖全局配置。

在 macOS 上让 VS Code 中的长代码或文本自动折行、不横向溢出屏幕，核心是开启 editor.wordWrap 设置。这不是 bug，而是默认关闭的设计——你需要手动启用，并根据使用场景选对模式。

快捷键临时开启（适合快速查看）

不用改配置，适合读日志、验接口返回、扫 Markdown 表格：

1. 按 Option + Z（macOS），当前文件立即切换换行/不换行
2. 右下角状态栏会显示“换行”或“不换行”，实时反馈
3. 注意：光标必须在编辑器主区域（不能在终端、搜索框或侧边栏），否则无效

全局永久开启（推荐日常开发）

让所有文件默认按窗口宽度软折行，一劳永逸：

1. 按 Cmd + , 打开设置
2. 搜索 word wrap，找到 Editor: Word Wrap
3. 下拉选择 on（不建议用 auto 或 inherit）
4. 或直接编辑 settings.json，加这一行：

   "editor.wordWrap": "on"

修复缩进错位（避免折行后“塌缩”）

默认折行会让第二行顶到最左，破坏 if 块、JSON 对象、链式调用的视觉结构：

1. 在 settings.json 中追加：

   "editor.wrappingIndent": "indent"

2. 效果：折行后的子行自动继承上一行缩进，对齐自然
3. 可选值还有 same（与首行同缩进）和 none（默认顶格），indent 最常用

检查语言专属设置是否覆盖了全局

有些文件类型（如 JSON、Markdown、YAML、log）常被插件或工作区配置单独关掉换行：

1. 打开一个不折行的文件，点击右下角语言标识（比如 “JSON”）
2. 选 Configure 'JSON' language specific settings
3. 查看是否有类似 "[json]": { "editor.wordWrap": "off" } 的配置
4. 删掉或改成 "on" 即可恢复