［授权发表］把 VIM 打造成源代码编辑器

by Wu Zhangjin [email protected] of TinyLab.org
2008-02-22

最初发表：泰晓科技 – 聚焦嵌入式 Linux，追本溯源，见微知著！
原文链接：把 VIM 打造成源代码编辑器
评论说明：为更好地聚合大家的讨论，请到上面原文的评论区回复。

---

【注】这是开源书籍《C语言编程透视》第一章，如果您喜欢该书，请关注我们的新浪微博@泰晓科技。

把VIM打造成源代码编辑器

前言

程序开发过程中，源代码的编辑主要是为了实现算法，结果则是一些可阅读的、便于检错的、可移植的文本文件。如何产生一份良好的源代码文件，这不仅需要一些良好的编辑工具，还需要开发人员养成良好的编程修养。

Linux下有很多优秀的程序编辑工具，包括专业的文本编辑器和一些集成开发环境(IDE)中提供的编辑工具，前者的代表作有vim和emacs，后者的代表作则有Eclipse，Kdevelope，Anjuta等，这里主要介绍vim的基本使用和一些基本配置。

常规操作

##通过vim进行文本编辑的一般过程包括：文件的打开、编辑、保存、关闭/退出，而编辑则包括插入新内容、替换已有内容、查找内容，还包括复制、粘贴、删除等基本操作。

该过程如下图：

Vim基本使用过程

下面介绍几个主要操作：

打开文件

在命令行下输入"vim 文件名"即可打开一个新的文件并进入vim的“编辑模式”。

编辑模式可以切换到命令模式（按下字符:）和插入模式（按下字母a/A/i/I/o/O/s/S/c/C等或者Insert键）。

编辑模式下，vim会把键盘输入解释成vim的编辑命令，以便实现诸如字符串查找(按下字母/)、文本复制（按下字母yy）、粘贴（按下字母pp）、删除（按下字母d等）、替换(s)等各种操作。

当按下a/A/i/I/o/O/s/S/c/C等字符时，vim先执行这些字符对应的命令动作（比如移动光标到某个位置，删除某些字符），然后进入插入模式；进入插入模式后可以通过按下ESC键或者是CTRL+C返回到编辑模式。

在编辑模式下输入冒号:后可进入命令模式，通过它可以完成一些复杂的编辑功能，比如进行正则表达式匹配替换，执行Shell命令（按下!命令）等。

实际上，无论是插入模式还是命令模式都是编辑模式的一种。而编辑模式却并不止它们两个，还有字符串查找、删除、替换等。

需要提到的是，如果在编辑模式按下字母v/V或者是CTRL+V，可以用光标选择一个区块，进而结合命令模式对这一个区块进行特定的操作。

编辑文件

打开文件以后即可进入编辑模式，这时可以进行各种编辑操作，包括插入、复制、删除、替换字符。其中两种比较重要的模式经常被“独立”出来，即上面提到的插入模式和命令模式。

保存文件

在退出之前需切换到命令模式，输入命令w以便保存各种编辑后的内容，如果想取消某种操作，可以用u命令。如果打开vim编辑器时没有设定文件名，那么在按下w命令时会提示没有文件名，此时需要在w命令后加上需要保存的文件名。

退出/关闭

保存好内容后就可退出，只需在命令模式下键入字符q。如果对文件内容进行了编辑，却没有保存，那么vim会提示，如果不想保存之前的编辑动作，那么可按下字符q并且在之后跟上一个感叹号!，这样会强制退出，不保存最近的内容变更。

命令模式

这里需要着重提到的是vim的命令模式，它是vim扩展各种新功能的接口，用户可以通过它启用和撤销某个功能，开发人员则可通过它为用户提供新的功能。下面主要介绍通过命令模式这个接口定制vim以便我们更好地进行源代码的编辑。

编码风格与indent命令

先提一下编码风格。刚学习编程时，代码写得很“难看”（不方便阅读，不方便检错，看不出任何逻辑结构），常常导致心情不好，而且排错也很困难，所以逐渐意识到代码编写需要规范，即养成良好的编码风格，如果换成俗话，那就是代码的排版，让代码好看一些。虽说“编程的“（高雅一些则称开发人员）不一定懂艺术，不过这个应该不是“搞艺术的”（高雅一些应该是文艺工作人员）的特权，而是我们应该具备的专业素养。在Linux下，比较流行的“行业”风格有KR的编码风格、gnu的编码风格、Linux内核的编码风格（基于KR的，缩进是8个空格）等，它们都可以通过indent命令格式化，对应的选项分别是-kr，-gnu，-kr -i8。下面演示用indent命令把代码格式化成上面的三种风格。

这样糟糕的编码风格看着会让人想“哭”，太难阅读啦：

    $ cat > test.c
    /* test.c -- a test program for using indent */
    #include
    
    int main(int argc, char *argv[])
    {
     int i=0;
     if (i != 0) {i++; }
     else {i--; };
     for(i=0;i<5;i++)j++;
     printf("i=%d,j=%dn",i,j);
    
     return 0;
    }

格式化成kr风格，好看多了：

    $ indent -kr test.c
    $ cat test.c
    /* test.c -- a test program for using indent */
    #include
    
    int main(int argc, char *argv[])
    {
        int i = 0;
        if (i != 0) {
            i++;
        } else {
            i--;
        };
        for (i = 0; i < 5; i++)
            j++;
        printf("i=%d,j=%dn", i, j);
        return 0;
    }

采用gnu风格，感觉不如kr的风格，处理if语句时增加了代码行，却并没明显改进效果：

    $ indent -gnu test.c
    $ cat test.c
    /* test.c -- a test program for using indent */
    #include
    
    int
    main (int argc, char *argv[])
    {
      int i = 0;
      if (i != 0)
        {
          i++;
        }
      else
        {
          i--;
        };
      for (i = 0; i < 5; i++)
        j++;
      printf ("i=%d,j=%dn", i, j);
      return 0;
    }

实际上indent命令有时候会不靠谱，也不建议“先污染再治理”，而是从一开始就坚持“可持续发展”的观念，在写代码时就逐步养成良好的风格。

用vim命令养成良好编码风格

从演示中可看出编码风格真地很重要，但是如何养成良好的编码风格呢？经常练习，遵守某个编码风格，一如既往。不过这还不够，如果没有一个好编辑器，习惯也很难养成。而vim提供了很多辅助我们养成良好编码习惯的功能，这些都通过它的命令模式提供。现在分开介绍几个功能；

  功效

vim命令

:syntax on

  语法加“靓”（亮）

:syntax off

  语法不加“靓”（亮）

:set cindent

  C语言自动缩进（可简写为set cin）

:set sw=8

  自动缩进宽度（需要set cin才有用）

:set ts=8

  设定TAB宽度

:set number

  显示行号

:set nonumber

  不显示行号

:setsm

  括号自动匹配

这几个对代码编写来说非常有用，可以考虑把它们全部写到~/.vimrc文件(vim启动时会去执行这个文件里头的内容)中，如；

    $ cat ~/.vimrc
    :set number
    :set sw=8
    :set ts=8
    :set sm
    :set cin
    :syntax on

相关小技巧

需要补充的几个技巧有；

• 对注释自动断行
  • 在编辑模式下，可通过gqap命令对注释自动断行（每行字符个数可通过命令模式下的set textwidth=个数设定）
• 跳到指定行
  • 命令模式下输入数字可以直接跳到指定行，也可在打开文件时用vim +数字 文件名实现相同的功能。
• 把C语言输出为html
  • 命令模式下的TOhtml命令可把C语言输出为html文件，结合syntax on，可产生比较好的web page把代码发布出去。
• 注释掉代码块
  • 先切换到可视模式（编辑模式下按字母v可切换过来），用光标选中一片代码，然后通过命令模式下的命令s#^#//#g把某这片代码注释掉，这非常方便调试某一片代码的功能。
• 切换到粘贴模式解决Insert模式自动缩进的问题
  • 命令模式下的set paste可解决复制本来已有缩进的代码的自动缩进问题，后可执行set nopaste恢复自动缩进。
• 使用vim最新特性
  • 为了使用最新的vim特性，可用set nocp取消与老版本的vi的兼容。
• 全局替换某个变量名
  • 如发现变量命名不好，想在整个代码中修改，可在命令模式下用%s#old_variable#new_variable#g全局替换。替换的时注意变量名是其他变量一部分的情况。
• 把缩进和TAB键都替换为空格
  • 可考虑设置expandtab，即set et，如果要把以前编写的代码中的缩进和TAB键都替换掉，可以用retab。
• 关键字自动补全
  • 输入一部分字符后，按下CTRL+P即可。比如先输入prin，然后按下CTRL+P就可以补全了。
• 在编辑模式下查看手册
  • 可把光标定位到在某个函数，按下Shift+k就可以调出man，很有用。
• 删除空行
  • 在命令模式下输入g/^$/d，前面g命令是扩展到全局，中间是匹配空行，后面d命令是执行删除动作。用替换也可以实现，键入%s#^n##g，意思是把所有以换行开头的行全部替换为空。类似地，如果要把多个空行转换为一个可以输入g/^n$/d或者%s#^n$##g。
• 创建与使用代码交叉引用
  • 注意利用一些有用的插件，比如ctags, cscope等，可以提高代码阅读、分析的效率。特别是open source的东西。
• 回到原位置
  • 在用ctags或cscope时，当找到某个标记后，又想回到原位置，可按下CTRL+T。

这里特别提到cscope，为了加速代码的阅读，还可以类似上面在~/.vimrc文件中通过map命令预定义一些快捷方式，例如：

    if has("cscope")
              set csprg=/usr/bin/cscope
              set csto=0
              set cst
              set nocsverb
              " add any database in current directory
              if filereadable("cscope.out")
                cs add cscope.out
              " else add database pointed to by environment
              elseif $CSCOPE_DB != ""
                cs add $CSCOPE_DB
              endif
              set csverb
    :map \ :cs find g =expand("")
    :map s :cs find s =expand("")
    :map t :cs find t =expand("")
    :map c :cs find c =expand("")
    :map C :cs find d =expand("")
    :map f :cs find f =expand("")
    endif

因为s,t,c,C,f这几个vim的默认快捷键用得不太多，所以就把它们给作为快捷方式映射了，如果已经习惯它们就换别的字符吧。

更多的技巧可以看看后续资料。

后记

实际上，在源代码编写时还有很多需要培养的“素质”，例如源文件的开头注释、函数的注释，变量的命名等。这方面建议看看参考资料里的编程修养、内核编码风格、网络上流传的《华为编程规范》，以及《C Traps & Pitfalls》, 《C-FAQ》等。

参考资料

• vim官方教程，在命令行下键入vimtutor即可
• vim实用技术序列: 实用技巧，常用插件，定制vim
• Graphical vi-vim Cheat Sheet and Tutorial
• vim高级命令集锦
• 内核编码风格: Document/codingstyle
• vim and Linux CodingStyle
• 编程修养
• C Traps & Pitfalls
• C FAQ