[VIM] 格式化代码

<b>快速使用</b><b>vim</b><b>格式化代码</b><b></b>

在vim的编辑模式i下直接ESC退出道命令模式之后直接敲入如下命令：

gg=G       

<b>将全部代码格式化</b><b></b>

nG=mG   

<b>将第</b><b>n</b><b>行到第</b><b>m</b><b>行的代码格式化</b>

<b>注</b>：如果ESC之后输入的是

<b>：gg=G</b> 即<b>前面加了个分号</b>‘：’那么就会有<b>不是编辑器命令</b>的提示。

<b>快速说明</b><b></b>

格式化全文指令 gg=G

自动缩进当前行指令 ==

格式化当前光标接下来的8行 8=

格式化选定的行 v 选中需要格式化的代码段 =

备注： 

gg   —— 到达文件最开始 

=    ——

要求缩进 

G     —— 直到文件尾 

<b>注释代码：</b><b>(</b><b>这个原理上就是使用</b><b>VIM</b><b>的正则替换</b><b>)</b>

以C++和Python为例。 

注释连续行： 

指令格式

:起始行,终止行s/要替换的字符/替换为字符/g 

如， 

C++源文件中注释掉10~20行，指令为： 

:10,20s/^/////g

Python源文件中注释掉10~20行，指令为： 

:10,20s/^/#/g

取消连续行注释： 

指令格式同上。只是要替换字符与替换为字符要互换： 

取消C++源文件中的10~20行的注释，指令为： 

:10,20s/^//////g

取消Python源文件中的10~20行的注释，指令为： 

:10,20s/^#//g

<b>详细说明</b>

先看一段简单的tutorial。

<b>Fix Indentation and Tabs in VIM</b>

Thanks to the folks in #vim on freenode, here‘s a quick

tutorial on <b>how to fix the indentation and tabs</b> in an xml file from

within VIM…

First find out what your current settings are by

typing:

<b>:filetype</b>

Should return something like “filetype

detection:ON plugin:OFF indent:OFF”

1) <b>:set filetype=xml</b>

2)

<b>:filetype indent on</b>

3) <b>:e</b>

4) <b>gg=G</b>

Basically

what this is doing is setting the filetype to xml (so it can pickup the XML

indenting rules (see <b>:e $VIMRUNTIME/indent</b> for a list of available

languages )

Then turn on indent, then reload it (:e).

The last step is

‘<b>gg=G</b> ‘  which will acutally retab the entire file (<b>gg is line 1, and G is last line</b> ).

You can find more info by reading vim help files:

:he

gg

:he =

:he G

:he :filetype

Note: Most commands in vim are run

with by typing “<b>:command</b> , you can find help by typing “<b>:help</b>

command ” or simply “<b>:he cmd</b> ”. HOWEVER, the main command to retab

“gg=G” is NOT preceeded by a “:” .

看完这段tutorial，我们遇到的问题基本就解决了。

Vim格式化代码功能——gg=G

<b>常用的几个功能：</b>

(1) gg=G 是一个自动缩进的命令 (在命令状态下直接输入，不需要输入冒号)，gg是文件首，G是文件尾，所以 gg=G 是整理全部代码。

(2) == 整理当行，加行数整理多行。

(3) ={ 或者 =i{ 整理一个代码块。

(4) mG=nG 当 m 不等于 n 的时候能完成从 m 行到 n 行的局部的缩进。例如，从80行缩进直到100行，你可以用 80G=100G，在命令状态下使用 :set nu 查看行号，一般更习惯将 se nu 直接写入Vim的配置文件，这样每次打开都会显示行号。

(5) 在写代码前，设置自己的代码风格。在配置文件里添加命令：

" 设置缩进和行号

set nu ru ai si ts=4 sw=4

(6) :set equalprg=indent

意思是用indent程序处理等号命令，indent默认是gnu风格。

建议不要改，代码风格应该自己主动养成，=适用于修改代码或者粘贴别处代码后整理缩进。

这里又体现出不用indent的好处了，如果用indent，单纯格式化代码块会丢统一的行首缩进，而且选中的如果不是内部完整的代码块，会出错，把出错的输出贴到了代码里....弊端很多。

1.12. 定宽文本排版

在传统的 Unix 环境下，文本文件的定义是具有一定长度限制的文本行的组合 [19]。虽然 Vim 本身对行的长度没有任何实际的限制，但有一些工具有这样的限制。为了最大程度的兼容性，也为了在显示、打印等处理上比较方便，一般推荐在邮件和源代码中一 般不要超出 72 列（最多不超出 80 列）。Vim 在处理定宽的文本方面具有特殊的支持能力。下面是一个在 Vim 中把行宽（使用选项 textwidth）设为 40 后输入 Harry Potter and the Half-Blood Prince 的第一句话的结果：

It was nearing midnight and the Prime Minister was sitting alone in

his office, reading a long memo that was slipping through his brain without

leaving the slightest trace of meaning behind.

输入时我只使用了英文字母和空格，换行符都是 Vim 自动插入的。如果在某一行加入或删除了一些字符后行不就不齐了吗，该如何处理？很简单，把光标移到要重新格式化的文本开头，使用“gq”命令后面跟一个光 标移动命令确定重新格式化的范围。比如“gq}”（格式化一段），“gq5j”（格式化 5 行），“gqG”（格式化至文件末尾）。

除了选项 textwidth 外，选项 formatoptions 确定了跟文本格式化有关的基本选项，常用的数值有：

·        

t：根据 textwidth 自动折行；

c：在（程序源代码中的）注释中自动折行，插入合适的注释起始字符；

r：插入模式下在注释中键入回车时，插入合适的注释起始字符；

q：允许使用“gq”命令对注释进行格式化；

n：识别编号列表，编号行的下一行的缩进由数字后的空白决定（与“2”冲突，需要“autoindent”）；

2：使用一段的第二行的缩进来格式化文本；

l：在当前行长度超过 textwidth 时，不自动重新格式化；

m：在多字节字符处可以折行，对中文特别有效（否则只在空白字符处折行）；

M：在拼接两行时（重新格式化，或者是手工使用“J”命令），如果前一行的结尾或后一行的开头是多字节字符，则不插入空格，非常适合中文

上面提到的注释，可以是 C/C++ 中的“//”和“/*”，也可以是邮件中引用原文使用的“&gt;”等字符（具体由 comments 选项控制；参见“:help ‘comments‘”）。Vim 在遇到这些字符时，能够相当智能地进行处理，足以完成日常编辑源代码和邮件的需要。在使用一些处理纯文本不够强大的邮件客户端时，我通常使用 Vim 编辑邮件（特别是英文邮件），然后把结果贴回到邮件编辑窗口中进行发送。

Vim 中 formatoptions 的缺省值是“tcq”，一般我会在 .vimrc 文件中加入一行“set formatoptions+=mM”来确保 Vim 能在中文字符之间折行而不要求空格的存在，并且在大部分情况下可以正确地处理中文重新格式化。