把 Vim 打造成源代碼編輯器

把 Vim 打造成源代碼編輯器

前言

程序開發(fā)過程中，源代碼的編輯主要是為了實現(xiàn)算法，結(jié)果則是一些可閱讀的、便于檢錯的、可移植的文本文件。如何產(chǎn)生一份良好的源代碼，這不僅需要一些良好的編輯工具，還需要開發(fā)人員養(yǎng)成良好的編程修養(yǎng)。

Linux 下有很多優(yōu)秀的程序編輯工具，包括專業(yè)的文本編輯器和一些集成開發(fā)環(huán)境（IDE）提供的編輯工具，前者的代表作有 Vim 和 Emacs，后者的代表作則有 Eclipse，Kdevelope，Anjuta 等，這里主要介紹 Vim 的基本使用和配置。

常規(guī)操作

通過 Vim 進行文本編輯的一般過程包括：文件的打開、編輯、保存、關閉/退出，而編輯則包括插入新內(nèi)容、替換已有內(nèi)容、查找內(nèi)容，還包括復制、粘貼、刪除等基本操作。

該過程如下圖：

下面介紹幾個主要操作：

打開文件

在命令行下輸入 vim 文件名 即可打開一個新文件并進入 Vim 的“編輯模式”。

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

編輯模式下，Vim 會把鍵盤輸入解釋成 Vim 的編輯命令，以便實現(xiàn)諸如字符串查找(按下字母 /)、文本復制（按下字母 yy）、粘貼（按下字母 pp）、刪除（按下字母 d 等）、替換（s）等各種操作。

當按下 a/A/i/I/o/O/s/S/c/C 等字符時，Vim 先執(zhí)行這些字符對應命令的動作（比如移動光標到某個位置，刪除某些字符），然后進入插入模式；進入插入模式后可以通過按下 ESC 鍵或者是 CTRL+C 返回到編輯模式。

在編輯模式下輸入冒號 : 后可進入命令模式，通過它可以完成一些復雜的編輯功能，比如進行正則表達式匹配替換，執(zhí)行 Shell 命令（按下 ! 命令）等。

實際上，無論是插入模式還是命令模式都是編輯模式的一種。而編輯模式卻并不止它們兩個，還有字符串查找、刪除、替換等。

需要提到的是，如果在編輯模式按下字母 v/V 或者是 CTRL+V，可以用光標選擇一個區(qū)塊，進而結(jié)合命令模式對這一個區(qū)塊進行特定的操作。

編輯文件

打開文件以后即可進入編輯模式，這時可以進行各種編輯操作，包括插入、復制、刪除、替換字符。其中兩種比較重要的模式經(jīng)常被“獨立”出來，即上面提到的插入模式和命令模式。

保存文件

在退出之前需切換到命令模式，輸入命令 w 以便保存各種編輯后的內(nèi)容，如果想取消某種操作，可以用 u 命令。如果打開 Vim 編輯器時沒有設定文件名，那么在按下 w 命令時會提示沒有文件名，此時需要在 w 命令后加上需要保存的文件名。

退出/關閉

保存好內(nèi)容后就可退出，只需在命令模式下鍵入字符 q。如果對文件內(nèi)容進行了編輯，卻沒有保存，那么 Vim 會提示，如果不想保存之前的編輯動作，那么可按下字符 q 并且在之后跟上一個感嘆號!，這樣會強制退出，不保存最近的內(nèi)容變更。

命令模式

這里需要著重提到的是 Vim 的命令模式，它是 Vim 擴展各種新功能的接口，用戶可以通過它啟用和撤銷某個功能，開發(fā)人員則可通過它為用戶提供新的功能。下面主要介紹通過命令模式這個接口定制 Vim 以便我們更好地進行源代碼的編輯。

編碼風格與 indent 命令

先提一下編碼風格。剛學習編程時，代碼寫得很“難看”（不方便閱讀，不方便檢錯，看不出任何邏輯結(jié)構(gòu)），常常導致心情不好，而且排錯也很困難，所以逐漸意識到代碼編寫需要規(guī)范，即養(yǎng)成良好的編碼風格，如果換成俗話，那就是代碼的排版，讓代碼好看一些。雖說“編程的“（高雅一些則稱開發(fā)人員）不一定懂藝術(shù)，不過這個應該不是“搞藝術(shù)的”（高雅一些應該是文藝工作人員）的特權(quán)，而是我們應該具備的專業(yè)素養(yǎng)。在 Linux 下，比較流行的“行業(yè)”風格有 KR 的編碼風格、GNU 的編碼風格、Linux 內(nèi)核的編碼風格（基于 KR 的，縮進是 8 個空格）等，它們都可以通過 indent 命令格式化，對應的選項分別是-kr，-gnu，-kr -i8。下面演示用 indent 命令把代碼格式化成上面的三種風格。

這樣糟糕的編碼風格看著會讓人想“哭”，太難閱讀啦：

$ cat > test.c
/* test.c -- a test program for using indent */
#include<stdio.h>

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=%d\n",i,j);

 return 0;
}

格式化成 KR 風格，好看多了：

$ indent -kr test.c
$ cat test.c
/* test.c -- a test program for using indent */
#include<stdio.h>

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=%d\n", i, j);
    return 0;
}

采用 GNU 風格，感覺不如 KR 的風格，處理 if 語句時增加了代碼行，卻并沒明顯改進效果：

$ indent -gnu test.c
$ cat test.c
/* test.c -- a test program for using indent */
#include<stdio.h>

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=%d\n", i, j);
  return 0;
}

實際上 indent 命令有時候會不靠譜，也不建議“先污染再治理”，而是從一開始就堅持“可持續(xù)發(fā)展”的觀念，在寫代碼時就逐步養(yǎng)成良好的風格。

需要提到地是，Linux 的編碼風格描述文件為內(nèi)核源碼下的 Documentation/CodingStyle，而相應命令為 scripts/Lindent。

用 Vim 命令養(yǎng)成良好編碼風格

從演示中可看出編碼風格真地很重要，但是如何養(yǎng)成良好的編碼風格呢？經(jīng)常練習，遵守某個編碼風格，一如既往。不過這還不夠，如果沒有一個好編輯器，習慣也很難養(yǎng)成。而 Vim 提供了很多輔助我們養(yǎng)成良好編碼習慣的功能，這些都通過它的命令模式提供?，F(xiàn)在分開介紹幾個功能；

這幾個命令對代碼編寫來說非常有用，可以考慮把它們?nèi)繉懙?~/.vimrc 文件（Vim 啟動時會去加載這個文件里頭的內(nèi)容）中，如：

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

相關小技巧

需要補充的幾個技巧有；

• 對注釋自動斷行

• 在編輯模式下，可通過 gqap 命令對注釋自動斷行（每行字符個數(shù)可通過命令模式下的 set textwidth=個數(shù) 設定）

• 跳到指定行

• 命令模式下輸入數(shù)字可以直接跳到指定行，也可在打開文件時用vim +數(shù)字 文件名實現(xiàn)相同的功能。

• 把 C 語言輸出為 html

• 命令模式下的TOhtml命令可把 C 語言輸出為 html 文件，結(jié)合 syntax on，可產(chǎn)生比較好的網(wǎng)頁把代碼發(fā)布出去。

• 注釋掉代碼塊

• 先切換到可視模式（編輯模式下按字母 v 可切換過來），用光標選中一片代碼，然后通過命令模式下的命令 s#^#//#g 把某這片代碼注釋掉，這非常方便調(diào)試某一片代碼的功能。

• 切換到粘貼模式解決 Insert 模式自動縮進的問題

• 命令模式下的 set paste 可解決復制本來已有縮進的代碼的自動縮進問題，后可執(zhí)行 set nopaste 恢復自動縮進。

• 使用 Vim 最新特性

• 為了使用最新的 Vim 特性，可用 set nocp 取消與老版本的 Vi 的兼容。

• 全局替換某個變量名

• 如發(fā)現(xiàn)變量命名不好，想在整個代碼中修改，可在命令模式下用 %s#old_variable#new_variable#g 全局替換。替換的時注意變量名是其他變量一部分的情況。

• 把縮進和 TAB 鍵都替換為空格

• 可考慮設置 expandtab，即 set et，如果要把以前編寫的代碼中的縮進和 TAB 鍵都替換掉，可以用 retab。

• 關鍵字自動補全

• 輸入一部分字符后，按下 CTRL+P 即可。比如先輸入 prin，然后按下 CTRL+P 就可以補全了。

• 在編輯模式下查看手冊

• 可把光標定位在某個函數(shù)，按下 Shift+k 就可以調(diào)出 man，很有用。

• 刪除空行

• 在命令模式下輸入 g/^$/d，前面 g 命令是擴展到全局，中間是匹配空行，后面 d 命令是執(zhí)行刪除動作。用替換也可以實現(xiàn)，鍵入 %s#^\n##g，意思是把所有以換行開頭的行全部替換為空。類似地，如果要把多個空行轉(zhuǎn)換為一個可以輸入 g/^\n$/d 或者 %s#^\n$##g。

• 創(chuàng)建與使用代碼交叉引用

• 注意利用一些有用的插件，比如 ctags, cscope 等，可以提高代碼閱讀、分析的效率。特別是開放的軟件。

• 回到原位置

• 在用 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 <C-R>=expand("<cword>")<CR><CR>
:map s :cs find s <C-R>=expand("<cword>")<CR><CR>
:map t :cs find t <C-R>=expand("<cword>")<CR><CR>
:map c :cs find c <C-R>=expand("<cword>")<CR><CR>
:map C :cs find d <C-R>=expand("<cword>")<CR><CR>
:map f :cs find f <C-R>=expand("<cword>")<CR><CR>
endif

因為 s,t,c,C,f 這幾個 Vim 的默認快捷鍵用得不太多，所以就把它們給作為快捷方式映射了，如果已經(jīng)習慣它們作為其他的快捷方式就換別的字符吧。

注 上面很多技巧中用到了正則表達式，關于這部分請參考：正則表達式 30 分鐘入門教程。

更多的技巧可以看看后續(xù)資料。

后記

實際上，在源代碼編寫時還有很多需要培養(yǎng)的“素質(zhì)”，例如源文件的開頭注釋、函數(shù)的注釋，變量的命名等。這方面建議看看參考資料里的編程修養(yǎng)、內(nèi)核編碼風格、網(wǎng)絡上流傳的《華為編程規(guī)范》，以及《C Traps & Pitfalls》, 《C-FAQ》等。

參考資料

• Vim 官方教程，在命令行下鍵入 vimtutor 即可

• vim 實用技術(shù)序列

• 實用技巧
• 常用插件

• 定制 Vim

• Graphical vi-vim Cheat Sheet and Tutorial
• Documentation/CodingStyle
• scripts/Lindent。
• 正則表達式 30 分鐘入門教程
• 也談 C 語言編程風格：完成從程序員到工程師的蛻變
• Vim 高級命令集錦
• 編程修養(yǎng)
• C Traps & Pitfalls
• C FAQ