[VIM] 格式化代码

快速使用vim格式化代码

---

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

gg=G        将全部代码格式化

nG=mG    将第n行到第m行的代码格式化

注：如果ESC之后输入的是 ：gg=G 即前面加了个分号‘：’那么就会有不是编辑器命令的提示。

快速说明

---

格式化全文指令 gg=G

自动缩进当前行指令 ==

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

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

备注：

gg   —— 到达文件最开始

=    —— 要求缩进

G     —— 直到文件尾

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

---

以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

详细说明

---

先看一段简单的tutorial。

Fix Indentation and Tabs in VIM

Thanks to the folks in #vim on freenode, here's a quick tutorial on how to fix the indentation and tabs in an xml file from within VIM…
First find out what your current settings are by typing:
:filetype

Should return something like “filetype detection:ON plugin:OFF indent:OFF”
1) :set filetype=xml
2) :filetype indent on
3) :e
4) gg=G

Basically what this is doing is setting the filetype to xml (so it can pickup the XML indenting rules (see :e $VIMRUNTIME/indent for a list of available languages )
Then turn on indent, then reload it (:e).
The last step is ‘gg=G '  which will acutally retab the entire file (gg is line 1, and G is last line ).
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 “:command , you can find help by typing “:help command ” or simply “:he cmd ”. HOWEVER, the main command to retab “gg=G” is NOT preceeded by a “:” .

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

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

常用的几个功能：

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

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