在 macos 的 vs code 中需手动启用 editor.wordwrap 实现自动折行:快捷键 option + z 临时切换,或设为 "on" 永久生效;配合 "editor.wrappingindent": "indent" 修复缩进错位,并检查语言专属设置是否覆盖全局配置。
在 macos 上让 vs code 中的长代码或文本自动折行、不横向溢出屏幕,核心是开启 editor.wordwrap 设置。这不是 bug,而是默认关闭的设计——你需要手动启用,并根据使用场景选对模式。
快捷键临时开启(适合快速查看)
不用改配置,适合读日志、验接口返回、扫 Markdown 表格:
- 按 Option + Z(macOS),当前文件立即切换换行/不换行
- 右下角状态栏会显示“换行”或“不换行”,实时反馈
- 注意:光标必须在编辑器主区域(不能在终端、搜索框或侧边栏),否则无效
全局永久开启(推荐日常开发)
让所有文件默认按窗口宽度软折行,一劳永逸:
- 按 Cmd + , 打开设置
- 搜索 word wrap,找到 Editor: Word Wrap
- 下拉选择 on(不建议用 auto 或 inherit)
- 或直接编辑
settings.json,加这一行:
"editor.wordWrap": "on"
修复缩进错位(避免折行后“塌缩”)
默认折行会让第二行顶到最左,破坏 if 块、JSON 对象、链式调用的视觉结构:
- 在
settings.json中追加:
"editor.wrappingIndent": "indent" - 效果:折行后的子行自动继承上一行缩进,对齐自然
- 可选值还有
same(与首行同缩进)和none(默认顶格),indent最常用
检查语言专属设置是否覆盖了全局
有些文件类型(如 JSON、Markdown、YAML、log)常被插件或工作区配置单独关掉换行:
- 打开一个不折行的文件,点击右下角语言标识(比如 “JSON”)
- 选 Configure 'JSON' language specific settings
- 查看是否有类似
"[json]": { "editor.wordWrap": "off" }的配置 - 删掉或改成
"on"即可恢复











