Vim 中的智能换行

Question

我一直想知道 Vim 是否有能力智能换行代码，以便它保持与缩进的行相同的缩进。 我在其他一些文本编辑器（例如电子文本编辑器）上注意到了它，并发现它可以帮助我更轻松地理解我正在查看的内容。

例如，而不是

<p>
    <a href="http://www.example.com">
        This is a bogus link, used to demonstrate
an example
    </a>
</p>

它会显示为

<p>
    <a href="somelink">
        This is a bogus link, used to demonstrate
        an example
    </a>
</p>

Answer 1

此功能已于 2014 年 6 月 25 日作为补丁 7.4.338 实施 。 随后有几个补丁完善了该功能，最后一个是 7.4.354，所以这就是您想要的版本。

:help breakindent
:help breakindentopt

下面摘录自 vim 帮助：

'breakindent'     'bri'   boolean (default off)
                          local to window
                          {not in Vi}
                          {not available when compiled without the |+linebreak|
                          feature}
        Every wrapped line will continue visually indented (same amount of
        space as the beginning of that line), thus preserving horizontal blocks
        of text.

'breakindentopt' 'briopt' string (default empty)
                          local to window
                          {not in Vi}
                          {not available when compiled without the |+linebreak|
                          feature}
        Settings for 'breakindent'. It can consist of the following optional
        items and must be seperated by a comma:
                  min:{n}     Minimum text width that will be kept after
                              applying 'breakindent', even if the resulting
                              text should normally be narrower. This prevents
                              text indented almost to the right window border
                              occupying lot of vertical space when broken.
                  shift:{n}   After applying 'breakindent', wrapped line
                              beginning will be shift by given number of
                              characters. It permits dynamic French paragraph
                              indentation (negative) or emphasizing the line
                              continuation (positive).
                  sbr         Display the 'showbreak' value before applying the 
                              additional indent.
        The default value for min is 20 and shift is 0.

与此相关的还有 showbreak 设置，这将以您指定的字符作为偏移量的后缀。

配置示例

" enable indentation
set breakindent

" ident by an additional 2 characters on wrapped lines, when line >= 40 characters, put 'showbreak' at start of line
set breakindentopt=shift:2,min:40,sbr

" append '>>' to indent
set showbreak=>>   

行为注意事项

如果您不指定 sbr 选项，则任何 showbreak 字符都会附加到缩进中。 从上面的示例中删除 sbr 会导致 4 个字符的有效缩进； 使用该设置，如果您只想使用 showbreak 而无需额外缩进，请指定 shift:0。

您还可以进行负移位，这会产生将 showbreak 字符和换行文本拖回任何可用缩进空间的效果。

指定 min 值时，如果终端宽度较窄，则移位量将被压缩，但始终保留 showbreak 字符。

Answer 2

有一个针对此问题的补丁，但它已经存在了几年，而且我上次检查时并没有完全应用。 请参阅 http://groups.google.com 中的“正确缩进换行”条目/group/vim_dev/web/vim-patches ——我真的希望这能进入主线。

更新：该链接似乎已损坏。 这是该补丁的更新版本。

更新 2：它已合并上游（截至 7.4.345），因此现在你只需要 :set breakindent 。

Answer 3

我认为不可能有完全相同的缩进，但您仍然可以通过设置“showbreak”选项获得更好的视图。

:set showbreak=>>>

示例：

<p>
    <a href="http://www.example.com">
        This is a bogus link, used to demonstrate
>>>an example
    </a>
</p>

真实的代码看起来比上面的示例代码更好，因为 Vim 对 '>>' 使用了不同的颜色。

Answer 4

更新：2014 年 6 月，一个补丁支持 breakindent 选项 已合并到 Vim（版本 7.4.346 或更高版本以获得最佳支持）。

---

您也可以尝试 :set nowrap 这将允许 vim 通过向右滚动来显示长行。 这对于检查文档的整体结构可能很有用，但对于实际编辑来说可能不太方便。

其他接近您要查找的选项是 linebreak 和 showbreak。 使用 showbreak，您可以修改换行行左边距显示的内容，但不幸的是，它不允许根据当前上下文进行变量缩进。

Answer 5

据我所知，您可以执行此操作的唯一方法是使用返回字符（如 Cfreak 提到的）并将 textwidth 选项与各种缩进选项结合起来。 如果您的缩进配置正确（我相信默认情况下使用的是 html 语法，但否则请参阅 autoindent 和 smartindent 选项），您可以：

:set formatoptions = tcqw
:set textwidth = 50
gggqG

如果您有自定义 formatoptions 设置，最好简单地执行以下操作：

:set fo += w
:set tw = 50
gggqG

它的作用：

:set fo+=w  " Add the 'w' flag to the formatoptions so 
            " that reformatting is only done when lines
            " end in spaces or are too long (so your <p>
            " isn't moved onto the same line as your <a...).
:set tw=50  " Set the textwidth up to wrap at column 50
gg          " Go to the start of the file
gq{motion}  " Reformat the lines that {motion} moves over.
G           " Motion that goes to the end of the file.

请注意，这与软换行不同：它将换行源文件中的行以及屏幕（当然除非你不保存它！）。 还有其他设置可以添加到 formatoptions 中，这些设置将在您键入时自动格式化：:help fo-table 中的详细信息。

有关更多信息，请参阅：

:help 'formatoptions'
:help fo-table
:help 'textwidth'
:help gq
:help gg
:help G
:help 'autoindent'
:help 'smartindent'

Answer 6

:set smartindent
:set autoindent

我认为你仍然需要使用退货

Answer 7

如果您的 HTML 格式足够好，通过 xmllint 运行它可能会有所帮助：

:%!xmllint --html --format

Answer 8

宏解决方案：

---

编辑：

操作gq{motion}自动格式化为变量“textwidth”设置的值。 这比使用我的宏的 80lBi^M 更容易/更好。

---

如果启用了自动缩进，

:set autoindent

则在行尾输入回车将使下一行缩进相同的量。 如果您愿意，可以使用它来硬输入换行。 以下宏利用此功能自动缩进文本：

将寄存器 z 设置为：

gg/\v^.{80,}$^M@x (change 80 to whatever length you want your text to be)

并将寄存器 x 设置为：

80lBi^M^[n@x (change 80 to whatever length you want your text to be)

然后执行

@x   

激活宏。 几秒钟后，您的文本将全部位于 80 个或更少字符的正确缩进行中。

说明：

这是对宏的剖析：

第 1 部分（宏 z）：

gg/\v^.{80,}$^M@x

gg - start at the top of the file (this avoids some formatting issues)
/  - begin search
\v - switch search mode to use a more generic regex input style - no weird vim 'magic'
^.{80,}$ - regex for lines that contain 80 or more characters
^M - enter - do the search (don't type this, you can enter it with ctrl+v then enter)
@x - do macro x

第 2 部分（宏 x）：

80lBi^M^[n@x

80l - move right 80 characters
B   - move back one WORD (WORDS include characters like "[];:" etc.)
i^M - enter insert mode and then add a return (again don't type this, use ctrl+v)
^[  - escape out of insert mode (enter this with ctrl+v then escape)
@x  - repeat the macro (macro will run until there are no more lines of 80 characters or more)

注意事项：

• 如果存在 80 个字符或更长的 WORD，此宏将中断。

• 此宏不会执行诸如在标签后缩进线之类的智能操作。

• 使用lazyredraw设置（:setlazyredraw）来加速