如何在VSCode中让多行注释里的文字自动换行对齐而不是超出屏幕右侧

VSCode 多行注释不自动换行，是因为默认禁用 word wrap

你是不是也遇到过这种情况？在 VSCode 里写一段长长的 // 或 /* */ 注释，文字一路向右狂奔，直到超出屏幕边界，不仅阅读起来费劲，编辑时也容易误操作。这背后的原因其实很简单：VSCode 默认关闭了编辑器的“软换行”功能。

解决思路很直接：打开设置，启用 editor.wordWrap。不过，光打开开关还不够，选对模式才是关键：

• "off"：完全不换行，也就是你看到的默认情况。
• "on"：在视口右边界强制折行，但可能会把单词从中间切断，比如把 userConfiguration 拆成 userConfigur 和 ation 两行。
• "wordWrapColumn"：按照指定的列数（通过 editor.wordWrapColumn 设置）进行折行，适合需要统一代码规范的项目。
• "bounded"：优先按视口宽度折行，同时会尽量避免在单词中间断开——**这是日常开发中最推荐的设置**。

注释里文字缩进错乱？检查 editor.comments.insertSpace 和自动格式化干扰

启用了换行，问题就彻底解决了吗？未必。你可能会发现，换行后的注释行首缩进变得乱七八糟，第二行要么顶到了最左边，要么凭空多出几个空格。这其实不是 wordWrap 的锅，而是因为 VSCode 的换行逻辑并没有模拟我们手动输入时的行为。

真正影响注释对齐的，通常是下面这两项配置：

• editor.comments.insertSpace：这个设置默认为 true，作用是确保在输入 // 后自动插入一个空格，避免写出 //TODO 这样紧贴着的注释。
• editor.formatOnType 以及语言插件的自动格式化：某些语言（比如 Ja vaScript、Python）的格式化工具会在你敲下回车时，自作主张地重新调整注释的缩进，反而破坏了原有的对齐效果。

一个实用的建议是：关闭那些对注释过于“热心”的即时格式化功能。例如，可以设置 "ja vascript.format.enable": false（或对应语言的类似选项），转而使用保存时格式化（editor.formatOnSa ve），这样控制权就完全在你手上了。

不同语言的多行注释行为不一致？关键看语言配置里的 comments

有没有感觉 VSCode 对待 /* ... */ 和 // 的换行方式，好像因语言而异？这就对了。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 单文件组件里，