VSCode多行注释不自动换行是因默认禁用软换行（editor.wordWrap），需设为"bounded"并启用editor.wordWrapOverrideInComments="on"，才能仅对注释折行且不断词。
VSCode 多行注释不自动换行，是因为默认禁用 word wrap
VSCode 默认关闭了编辑器的「软换行」功能，所以即使你写了一长串 // 或 /* */ 注释，它也不会在视口边缘自动折行，而是横向滚动——看着费眼，改起来也容易误触。
解决方法很简单：打开设置，启用 editor.wordWrap。但要注意，光开这个还不够，还得选对模式：
-
"off"：完全不换行（默认值） -
"on"：强制在视口右边界处折行，但可能切在单词中间（比如把userConfiguration拆成两行） -
"wordWrapColumn"：按指定列数（editor.wordWrapColumn）折行，适合统一规范 -
"bounded"：优先按视口宽度折行，同时避免切开单词——**推荐日常使用**
注释里文字缩进错乱？检查 editor.comments.insertSpace 和自动格式化干扰
启用换行后，你可能会发现换行后的注释行首缩进不一致，比如第二行突然顶到最左边，或多了几个空格。这不是 wordWrap 的问题，而是 VSCode 在换行时没“模拟”人工输入逻辑。
真正影响注释对齐的是这两项：
-
editor.comments.insertSpace：设为true（默认），确保//后自动加一个空格，避免//TODO紧贴着写 -
editor.formatOnType和语言插件的自动格式化：某些语言（如 JavaScript、Python）的 formatter 会在你敲回车时重排注释缩进，反而破坏对齐
建议关掉注释敏感的自动格式化："javascript.format.enable": false（或对应语言），改用保存时格式化（editor.formatOnSave）更可控。
不同语言的多行注释行为不一致？关键看语言配置里的 comments
VSCode 对 /* ... */ 和 // 的换行表现，其实依赖语言扩展提供的 comments 配置。比如 Python 没有块注释语法，它的 """docstring""" 不会被 editor.wordWrap 自动处理；而 TypeScript 的 /** */ JSDoc 则可能被 TSServer 格式化覆盖。
验证方式：打开任意文件 → Ctrl+Shift+P → 输入 Developer: Inspect Editor Tokens and Scopes → 看当前光标处的 language 和 token type。如果显示为 comment.block 或 comment.line，说明语言配置正常；如果是 string 或 invalid，那换行逻辑就不可靠。
常见坑：
- C/C++ 扩展里
/* */是标准块注释，wordWrap生效；但//行注释在宏定义里（如#define LOG(x) do { /*...*/ } while(0)）可能被忽略 - Vue 单文件组件中，
里的 HTML 注释属于 HTML 语言模式，需单独确认 HTML 扩展是否启用wordWrap
想让换行只发生在注释里，不影响代码？得靠 editor.wordWrapOverrideInComments
这是个冷门但关键的配置项。默认情况下，editor.wordWrap 对所有文本生效，包括代码行本身——你可能不希望 const result = someVeryLongFunctionName(arg1, arg2, arg3, arg4); 被折行。
把 editor.wordWrapOverrideInComments 设为 "on"，就能让换行逻辑只作用于注释区域（comment.line / comment.block），代码行保持原样。配合 editor.wordWrap: "bounded"，效果最干净。
实操建议：在工作区 .vscode/settings.json 中写死，避免污染全局设置：
{
"editor.wordWrap": "bounded",
"editor.wordWrapOverrideInComments": "on"
}
注意：这个选项在旧版 VSCode（editor.wordWrapOverrideInComments，新版已统一，但拼写错误会导致静默失效。
真正麻烦的是嵌套场景：比如注释里写了 JSON 示例、SQL 片段或正则表达式，这些内容本身不该被折行切开。这时候就得手动加 /* prettier-ignore */ 或换用单行注释分段，没有银弹。
