DIFF
*diff.txt* For Vim version 7.3. 最后修改: 2010年8月
VIM REFERENCE MANUAL by Bram Moolenaar
译者: Zimin<cranecai@users.sf.net>, tocer
http://vimcdoc.sf.net
*diff* *vimdiff* *gvimdiff* *diff-mode*
这篇文章描述 |+diff| 特性: 比较同一文件的两、三或四个版本间的差异。
用户手册 |08.7| 节说明了一些 diff 基本的用法。
1. 进入比较模式 |vimdiff|
2. 查看比较结果 |view-diffs|
3. 跳转到差异文 |jumpto-diffs|
4. 复制差异文本 |copy-diffs|
5. diff 选项 |diff-options|
{Vi 无此功能}
1. 进入比较模式
进入比较模式编辑的最简单方法就是用 "vimdiff" 命令。它如常启动 Vim，但附加一些
设置，以便于查看输入参数所指定的文件间的差异:
vimdiff file1 file2 [file3 [file4]]
vim -d file1 file2 [file3 [file4]]
vimdiff -o file1 file2 [file3 [file4]]
if &diff
setup for diff mode
else
setup for non-diff mode
endif
{filename} *:diffs* *:diffsplit*
对 {filename} 开一个新窗口。当前的和新开的窗口将设定和
"vimdiff" 一样的参数。另见 'diffexpr'。
*:difft* *:diffthis*
:diffthis 使当前窗口参与比较。本命令设定和 "vimdiff" 同样的选项。
:diffpatch {patchfile} *E816* *:diffp* *:diffpatch*
使用当前的缓冲区，用 {patchfile} 给它打上补丁并打开一个缓冲区
显示结果。两个缓冲区都将设定为和 "vimdiff" 同样的参数。
{patchfile} 可以是任何一种 "patch" 程序认识的或 'patchexpr' 可
以处理的格式。
注意: {patchfile} 只能包含一个文件的比较结果: 当前文件。如果
{patchfile} 也包含了其他文件的比较，结果将不可预知。Vim 改变当
前目录到 /tmp， 以避免当前目录下的文件被意外的打补丁。但它仍不
能避免若干 ".rej" 文件产生。当绝对路径名出现时，这些文件也不能
避免被打补丁。
要垂直分割窗口，在前面加上 |:vertical|。例如:
:vert diffsplit main.c :vert diffpatch /tmp/diff
2. 查看比较结果 *view-diffs*
比较产生的结果是，不同比较窗口显示同一文件不同版本，高亮标出差异的部分。当滚动
文本时，'scrollbind' 选项将使得另一窗口的相应文本也随着滚动。垂直分割时，文本
会恰当地对齐。
不过，以下情况将使文本对齐出现问题:
- 当设置了 'wrap' 后，一些行将被自动换行，在屏幕上占用两行以上。
- 一个缓冲区打开了折叠，另一个却没有。
- 'scrollbind' 被关闭
- 文本做过改动
- 'diffopt' 中没有 "filler"，插入或删除的行会使对齐出错
所有打开 'diff' 选项并在某一个窗口编辑的缓冲区都将参与比较。即使对于一个隐藏的
缓冲区也是如此，如果它曾在一个窗口内被编辑过的话。
*:DiffOrig* *diff-original-file*
因为 'diff' 是一个局部于窗口的选项，所以同一缓冲区可以在某一个窗口里是比较模
式，而在另一个窗口里则是普通模式。你也可能想查看对一缓冲区在读入文件后所做过的
改动。既然 Vim 不允许同一个文件有 2 个缓冲区，你需要另一个缓冲区。可用下面的命
令:
command DiffOrig vert new | set bt=nofile | r # | 0d_ | diffthis
\ | wincmd p | diffthis
(|vimrc_example.vim| 里有该示例)。之后，使用 ":DiffOrig" 就可以查看当前缓冲区
和它刚从文件里载入时的不同之处。
要 注意: 已经卸载的缓冲区不能参与比较。但一个隐藏的缓冲区是可以的。你可以使用
":hide" 来关闭但不卸载窗口。如果你不想缓冲区继续参与比较，可以在隐藏前先执行
":set nodiff"。
*:diffu* *:diffupdate*
:diffu[pdate] 刷新比较结果的高亮和折叠。
在改变文本时，Vim 试图更新比较的结果。插入或删除行一般会得到正确的更新。但行内
或者更复杂的改动将无法如此。要强制刷新比较结果，使用:
:diffupdate
:set diffopt=filler,context:3
3. 跳转到差异文 *jumpto-diffs*
有两条命令可用于在跳转到差异文所在的位置:
*[c*
[c 反向跳转至上一处更改的开始。计数前缀使之重复执行相应
次。
*]c*
]c 正向跳转至下一个更改的开始。计数前缀使之重复执行相应
次。
如果不存在光标可以跳转到的更改，将产生错误。
4. 复制差异文本 *copy-diffs* *E99* *E100* *E101* *E102* *E103*
*merge*
有两个命令可用来在两个缓冲区之间复制文本。相应的结果是，在一定的范围内两缓冲区
的内容被统一。
*:diffg* *:diffget*
:[range]diffg[et] [bufspec]
用另一个缓冲区来修改当前的缓冲区，消除不同之处。除非只有另外一
个比较模式下的缓冲区， [bufspec] 必须存在并指定那个缓冲区。
如果 [bufspec] 指定的是当前缓冲区，则为空动作。
[range] 可以参考下面。
*:diffpu* *:diffput* *E793*
:[range]diffpu[t] [bufspec]
用当前缓冲区来修改另一个缓冲区，消除不同之处。不同于
":diffget" 之处仅在于被更改的是另一个缓冲区。
如果忽略 [bufspec]，而多于一个缓冲区处于比较模式并置位
'modifiable' 的话，此命令失败。
[range] 可以参考下面。
*do*
do 同 ":diffget"，但没有参数和范围。"o" 表示 "obtain" (不能用
"dg"，因为那可能是 "dgg" 的开始！)。
*dp*
dp 同 ":diffput"，但没有参数和范围。
当没有给定 [range] 时，受影响的仅是当前光标所处位置或其紧上方的差异文本。
当指定 [range] 时，Vim 试图仅改动它指定的行。不过，当有被删除的行时，这不总有
效。
可能在最后一行之后有删除的行。要从另一个缓冲区中取得那些行，可使用最后一行的行
号加一来实现。以下命令从另一个缓冲区中得到所有的差异文本:
:1,$+1diffget
5. diff 选项 *diff-options*
也可参考 |'diffopt'| 和 |'fillchars'| 中的 "diff" 项。
查 找 不 同 *diff-diffexpr*
'diffexpr' 选项可以用来设定非标准的 "diff" 程序，用来比较文件间的异同。
当 'diffexpr' 为空的时候，Vim 使用以下命令在 file1 和 file2 中查找不同之处:
diff file1 file2 > outfile
1a2
> bbb
4d4
< 111
7c7
< GGG
> ggg
set diffexpr=MyDiff()
function MyDiff()
let opt = ""
if &diffopt =~ "icase"
let opt = opt . "-i "
endif
if &diffopt =~ "iwhite"
let opt = opt . "-b "
endif
silent execute "!diff -a --binary " . opt . v:fname_in . " " . v:fname_new .
\ " > " . v:fname_out
endfunction
其中，"-a" 参数被用来强制将文件作为文本来比较，二进制的比较没有什么意义。
"--binary" 参数使得文件以二进制模式读入，这样在 DOS 上 CTRL-Z 就不会结束文本。
*E810* *E97*
Vim 将测试 diff 的输出看上去是否完全正确。如果不正确，你将得到一个错误信息。可
能是因为:
- "diff" 程序无法执行。
- "diff" 程序无法产生普通 "ed" 风格的 diff 文件 (参考上面)。
- 'shell' 和相关选项没有正确设置。试试类似 ":!sort" 过滤运行是否正确。
- 你设置的 'diffexpr' 可能不正确。
如果问题出在哪里不是很清楚，可以设置 'verbose' 选项为一或更高的值，以获得更多
的信息。
自安装的 Vim 包含了 diff 程序。如果没有，您可以自行下载 diff.exe。例如从这里
http://jlb.twu.net/code/unixkit.php。
使 用 补 丁 *diff-patchexpr*
选项 'patchexpr' 可以用来设定非标准的 "patch" 程序。
当 'patchexpr' 为空时，Vim 将这样调用 "patch" 程序:
patch -o outfile origfile < patchfile
set patchexpr=MyPatch()
function MyPatch()
:call system("patch -o " . v:fname_out . " " . v:fname_in .
\ " < " . v:fname_diff)
endfunction