vscode 默认不自动换行是设计选择，需显式设置 editor.wordwrap；其生效受语言专属配置优先级影响，快捷键 alt+z 仅在编辑器主区域有效，且需配合 editor.wrappingindent 保证缩进对齐。

VSCode 默认不自动换行，不是 bug，是明确的设计选择；editor.wordWrap 必须显式设置才生效，且极易被语言专属配置、插件或作用域覆盖。

按 Alt+Z / Option+Z 没反应？检查焦点和语言设置

快捷键只对当前**激活的编辑器主区域**有效。常见失效场景：

• 光标在终端、搜索框、侧边栏或调试控制台里——此时快捷键完全无响应
• 当前文件类型（如 .json、.md）启用了 language-specific 设置，例如右下角显示“JSON”，点击它后看到 "editor.wordWrap": "off"，该配置优先级高于全局设置
• 已打开的文件未刷新渲染：改完全局设置后，需手动按一次 Alt+Z 才触发重绘

全局设了 "editor.wordWrap": "on" 还是不换行？优先查 language-specific 配置

VSCode 的设置优先级顺序是：language-specific > workspace > user。哪怕你在用户设置里写了 "editor.wordWrap": "on"，只要打开的是 JSON 文件，它仍可能不换行——因为 VSCode 内置的 JSON 语言配置默认关掉了这个功能。

验证与修复步骤：

• 打开一个不换行的文件（比如 config.json）
• 点击右下角语言标识（如 “JSON”）→ 选 “Configure 'JSON' language based settings”
• 检查打开的 settings.json 片段中是否有 "editor.wordWrap": "off"
• 删掉这行，或显式改为 "editor.wordWrap": "on"

别依赖“右键 → 自动换行”，那只是会话级临时开关，关掉文件就失效。

Teleport tsh SSH (Identity-First SSH Access, no passwords/static keys)

使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。

下载

editor.wordWrap 四个值的实际行为差异

选错值会导致“开了等于没开”或“换得莫名其妙”：

• "off"：默认值，强制水平滚动
• "on"：按视口宽度折行，窗口缩放时实时重排，适合日常写代码
• "wordWrapColumn"：严格按 editor.wordWrapColumn（如 120）字符数硬切，无视窗口大小；必须同时设置 "editor.wordWrapColumn": 120 才生效
• "bounded"：取视口宽度和 editor.wordWrapColumn 中较小值作为折行依据，但窗口缩小时行为突变，实际难预测，不推荐作为默认
• "auto" 和 "inherit" 不要选："auto" 几乎等同于 "off"；"inherit" 易被插件或工作区覆盖，行为不可控

换行后缩进顶格、对齐错乱？加 "editor.wrappingIndent": "indent"

默认软折行会让第二行直接顶到行首，破坏嵌套结构的视觉连贯性（比如链式调用、缩进注释）。修复只需一行：

"editor.wrappingIndent": "indent"

它会让折行后的子行继承上一行的缩进层级。注意：

• 这个配置不影响真实内容，只改变显示对齐
• 如果仍不对齐，可能是字体问题（如某些等宽字体缺少软连字支持），换 Fira Code 或 JetBrains Mono 通常能改善
• editor.wordWrap 是纯渲染层行为，不插入真实换行符，Git diff、保存、复制粘贴均不受影响

最容易被忽略的点：language-specific 设置不仅存在，而且默认就开着——尤其对 .json、.log、.md 这类非代码文件，它们往往自带 "editor.wordWrap": "off"，不主动检查就会一直卡在“为什么设了还不换行”的循环里。