|
|
发表于 2004-9-23 19:03:27
|
显示全部楼层
:help quickfix
- QUICKFIX
- *quickfix.txt* For Vim version 6.2. 最近更新：2004年6月
- VIM REFERENCE MANUAL by Bram Moolenaar
- (本章译者: wandys [url]http://vimcdoc.sf.net[/url])
- 本主题曾在用户手册的 |30.1| 节有所介绍。
- 1. 使用 QuickFix 命令 |quickfix|
- 2. 出错窗口 |quickfix-window|
- 3. 使用多个错误列表 |quickfix-error-lists|
- 4. 使用 :make |:make_makeprg|
- 5. 使用 :grep |grep|
- 6. 选择编译器 |compiler-select|
- 7. 错误格式 |error-file-format|
- 8. 目录栈 |quickfix-directory-stack|
- 9. 特定错误格式 |errorformats|
- {Vi 没有这些命令}
- 如编译时没有指定 |+quickfix| 则无法使用 quickfix 相关命令。
- 1. 使用 QuickFix 命令 *quickfix* *Quickfix* *E42*
- Vim 有一个特殊的模式用来加快 编辑-编译-编辑 循环。这是受到 Amiga 系统上 Manx
- 的 Aztec C 编译器的 quickfix 选项的启发。它会将编译器产生的出错信息保存到一个
- 文件中并用 Vim 跳转到各个错误。无需记住所有的出错信息，你可以检查每一个错误并
- 对其修正。
- 如果你是在 Amiga 系统上使用 Manx 的 Aztec C 编译器，参考 |quickfix-manx| 以配
- 合 Vim 使用。如果使用其它的编译器，你需要将出错信息保存到一个文件中然后用
- "Vim -q filename" 启动 Vim。一个简便的方法是使用 |:make| 命令（见下）。
- 设定 'errorformat'，使其和编译器产生的出错信息格式一致（见 |errorformat|）。
- 以下 quickfix 命令可供使用：
- *:cc*
- :cc[!] [nr] 显示错误 [nr]。如果不指定 [nr]，将再次显示相同的错误。
- 若 'hidden' 和 'autowrite' 选项没被设定并且当前缓冲只
- 有一个窗口且被修改，如果不指定 [!]，则无法跳转到另一
- 个缓冲。指定 [!] 跳转到另一个缓冲时，当前缓冲的修改则
- 会丢失，除非指定 'hidden' 或该缓冲还有其它窗口。当跳转
- 到另一个缓冲时，会受到 'switchbuf' 有关设定的影响。
- *:cn* *:cnext* *E553*
- :[count]cn[ext][!]d 显示含有文件名的列表中的下 [count] 个错误。如果没有文
- 件名，则跳转到下 [count] 个错误。有关 [!] 和
- 'switchbuf'，参见 |:cc|。
- :[count]cN[ext][!] *:cp* *:cprevious* *:cN* *:cNext*
- :[count]cp[revious][!] 显示含有文件名的列表中的前 [count] 个错误。如果没有文
- 件名，则跳转到前 [count] 个错误。有关 [!] 和
- 'switchbuf'，参见 |:cc|。
- *:cnf* *:cnfile*
- :[count]cnf[ile][!] 显示含有文件名列表中下 [count] 个文件中的首个错误。如
- 果没有文件名或是列表中没有下一个文件，则跳转到下
- [count] 个错误。有关 [!] 和 'switchbuf'，参见 |:cc|。
- *:crewind* *:cr*
- :cr[ewind][!] [nr] 显示错误 [nr]。如果没指定 [nr]，则显示首个错误。参见
- |:cc|。
- *:cfirst* *:cfir*
- :cfir[st][!] [nr] 和 ":crewind" 相同。
- *:clast* *:cla*
- :cla[st][!] [nr] 显示错误 [nr]。如果没指定[nr]，则显示最后一个错误。参
- 见 |:cc|。
- *:cq* *:cquit*
- :cq[uit] 以错误码退出 Vim。这样编译器就不会再次编译相同文件。
- *:cf* *:cfile*
- :cf[ile][!] [errorfile] 读入错误文件并跳转到首个错误。以 -q 选项启动 Vim 时会
- 自动这样处理。你可以在编译的同时使用这个命令。如果你指
- 定错误文件名，那么 'errorfile' 选择将被设定为
- [errorfile]。有关 [!]，参见 |:cc|。
- *:cg* *:cgetfile*
- :cg[etfile][!] [errorfile]
- 读入错误文件。和 ":cfile" 类似，只是不跳转到首个错误。
- *:cl* *:clist*
- :cl[ist] [from] [, [to]]
- 显示所有有效的错误（参见 |quickfix-valid）。
- 如果 [from] 和/或 [to] 被指定，则显示指定范围内的错误。
- 负数从最后一个错误向前算起，-1 为最后一个错误。当跳转
- 到另一个缓冲时，会受到 'switchbuf' 有关设定的影响。
- :cl[ist]! [from] [, [to]]
- 显示所有的错误。
- 如果你插入或删除行，大部分错误仍能被正确的找到，因为隐藏标记会被使用。有时，
- 当标记由于某种原因被删除，"line changed" 信息会显示以警告你出错位置可能有误。
- 如果你退出并重新运行 Vim，标记会丢失，而出错位置也可能不再正确。
- 2. 出错窗口 *quickfix-window*
- *:cope* *:copen*
- :cope[n] [height] 打开一个窗口显示当前列表中的错误。如果指定 [height]，
- 窗口则为指定高度，否则窗口为 10 行高。
- 该窗口还有一个特殊的缓冲，'buftype' 为 "quickfix"，不
- 要修改此选项。 如果已有了一个 quickfix 窗口，它将成为
- 当前窗口。 不可能再打开第二个 quickfix 窗口。
- *:ccl* *:cclose*
- :ccl[ose] 关闭 quickfix 窗口.
- *:cw* *:cwindow*
- :cw[indow] [height] 当有识别出的错误时，打开窗口。如果该窗口已经打开且没有
- 识别出的错误，则将此窗口关闭。
- quickfix 窗口一般会在屏幕的底端。如果有垂直分割, 它会在最右边窗口的底端。
- 要使其获得最大宽度:
- :botright cwindow
- 你可以用 |windows-moving| 命令来移动窗口。
- 比如，将它移动到顶端: CTRL-W K
- 'winfixheight' 选项会被设定，也就是说窗口会尽可能的保持它原来的高度，而忽略
- 'winheight' 和 'equalalways' 选项。你可以手动改变其高度（例如，用鼠标拖动其上
- 的状态线）。
- 在 quickfix 窗口中，每一行是一个错误。行号和错误号相等。你可以用 ":.cc" 跳转到
- 当前光标处的错误，按 <CR> 键或是双击鼠标有同样的效果。在 quickfix 窗口上方会开
- 一窗口显示含有错误的文件。如果已有窗口为该文件打开，则用此窗口。如果已打开窗口
- 的缓冲已被修改，而错误出在另一个文件中，则不能完成向出错处的跳转。你需要首先确
- 定窗口含有一个可被废除的缓冲.
- 当 quickfix 窗口充满时，将会触发两个自动命令事件。首先，'filetype' 选项会被设
- 为 "qf"，这会触发 FileType 事件。然后 BufReadPost 事件会被触发。这可以用来完成
- 在列出错误上的相同操作。比如:
- au BufReadPost quickfix silent g/^/s//\=line(".")." "/
- 这会在每行首添加行号。 注意 ":s" 命令中 "\=" 的使用，它是为了计算表达式。
- Note: 在 quickfix 窗口中作更改对出错列表不起作用。'modifiable' 选项关闭以免作
- 出更改。如果你删除或是插入了行，文本和错误号的关系就会混乱。如果真的想这么做，
- 你可以将 quickfix 窗口的内容保存到一个文件中然后用 ":cfile" 命令将其解析并指定
- 其作为新的错误列表。
- 3. 使用多个错误列表 *quickfix-error-lists*
- 到目前为止，我们都假定只有一个错误列表。实际上最近使用的 10 个错误列表都会被
- 记住。当开始一个新的列表，前面的列表会被自动保存。有两个命令可以用来访问旧的
- 错误列表。它们会将已经使用的错误列表指定为当前列表。
- *:colder* *:col* *E380*
- :col[der] [count] 到前一个旧的错误列表。如果指定 [count]，则执行 [count]
- 次。如果已经到达最旧的列表，则报错。
- *:cnewer* *:cnew* *E381*
- :cnew[er] [count] 到下一个新的错误列表。如果指定 [count]，则执行 [count]
- 次。如果已经到达最新的列表，则报错。
- 当增加一个错误列表，它会成为当前列表。
- 如果使用 ":colder" 后又使用 ":make" 或 ":grep" 来增加一个错误列表，那么原来的
- 一个较新列表会被覆盖。这在使用 ":grep" （见 |grep|）时相当有用。如果你想保留最
- 近的错误列表，先要使用 ":cnewer 99" 命令。
- 4. 使用 :make *:make_makeprg*
- *:mak* *:make*
- :mak[e][!] [arguments] 1. 如果设定 'autowrite'，则写入所有修改过的缓冲。
- 2. 错误文件名为 'makeef' 设定的值。如果 'makeef' 值不
- 包含 "##" 且此文件已存在，则该文件会被先删除。
- 3. 'makeprg' 选项指定的程序 （省缺为 "make"）被启动，
- [arguments] 为其参数。其输出被储存到错误文件名（如
- 是 Unix，也会在屏幕上显示）。
- 4. 错误文件以 'errorformat' 格式读入。
- 5. 如果没指定 [!]，则跳转到首个错误。
- 6. 错误文件被删除。
- 7. 你现在可以用 |:cnext|，|:cprevious| 等命令在错误间
- 移动。
- 本命令不接受注释，所有的 " 将被视为参数的一部分。
- ":make" 命令执行 'makeprg' 选项指定的程序。这会通过将命令传递给 'shell' 指定的
- shell 完成。就像输入下面的命令一样：
- ":!{makeprg} [arguments] {shellpipe} {errorfile}".
- {makeprg} 是 'makeprg' 选项指定的值。并非只是 "make"，所有的命令都可被使用。
- '%' 和 '#' 会像在命令行中一样被展开。你可以用 "%<" 表示不含扩展名的当前文件
- 名，用 "#<" 表示不含扩展名的备选文件名。例如：
- :set makeprg=make\ #<.o
- [arguments] 为 ":make" 之后输入的所有字符。
- {shellpipe} 是 'shellpipe' 选项值。
- {errorfile} 是 'makeef' 选项值（ ## 会被一个唯一字符串取代）。
- 在设定 {makeprog} 时，"$*" 可用来指代 [arguments]。比如:
- :set makeprg=latex\ \\\\nonstopmode\ \\\\input\\{$*}
- 或更简单些:
- :let &mp = 'latex \\nonstopmode \\input\{$*}'
- "$*" 可被使用多次:
- :set makeprg=gcc\ -o\ $*\ $*
- 'shellpipe' 在 Amiga, MS-DOS 以及 Win32 系统上省缺为 ">"。这就是说编译器的输出
- 会保存在一个文件中而不在屏幕中直接显示。在 Unix 系统上， 会用到 "| tee" 。输出
- 在被保存在文件中的同时也会显示在屏幕上。取决于所使用的 shell，"|& tee" 或是
- "2>&1| tee" 为省缺值，这样 stderr 输出也被包括。
- 如果 'shellpipe' 为空，{errorfile} 将被忽略。这对那些自身将输出写入文件的编译
- 器很有用（比如，Manx 的 Aztec C）。
- 5. 使用 :grep *grep* *lid*
- Vim 可以和 "grep" 或类似 grep 的程序（比如 GNU id-utils）交互，其方式和与编译器
- 交互方式类似。
- [Unix 小常识: Unix 上 "grep" 命令的名字来源与 ":g/re/p"，其中 "re" 是正则表达
- 式 (Regular Expression) 的意思。]
- *:gr* *:grep*
- :gr[ep][!] [arguments] 和 ":make" 类似，但以 'grepprg' 替代 'makeprg'，以
- 'grepformat' 替代 'errorformat'。
- *:grepa* *:grepadd*
- :grepa[dd][!] [arguments]
- 和 ":grep" 类似，但不另建一个新的错误列表，只是将匹配
- 附加到当前列表中。
- 比如:
- :grep nothing %
- :bufdo grepadd! something %
- 第一个命令新建一个空的错误列表。第二个命令对每个列出的
- 缓冲执行 "grepadd"。注意 ! 的使用是避免 ":grepadd" 跳
- 转到首个错误。
- 5.1 设定 grep
- 如果你已安装了一个标准的 "grep" 程序，:grep 命令会以省缺方式运行。格式和标准命
- 令很类似:
- :grep foo *.c
- 会对每个 .c 文件搜索字符串 "foo"。:grep 的参数直接传递给 "grep" 程序，这样你就
- 可以使用 "grep" 支持的任何选项。
- 省缺状态下，:grep 会以 -n 参数启动 grep （显示文件和行号）。你可以通过设定
- 'grepprg' 对此改变。你需要设定 'grepprg'，如果：
- a) 你在使用一个不叫 "grep" 的程序。
- b) 你需要以绝对路径启动 grep。
- c) 你想自动传递某些参数（比如，忽略大小写）。
- "grep" 执行后，Vim 会用 'grepformat' 选项解析其结果。该选项和 'errorformat' 的
- 工作方式相同。如果你的 grep 输出不是标准格式或是你使用具有特定格式的程序，你可
- 以通过设定 'errorformat' 来改变省缺值。
- 解析完结果，Vim 会载入第一个含有匹配的文件并跳转到相应行，与在 |quickfix| 模式
- 中跳转到一个编译错误的方式相同。你可以使用 |:cnext|，|:clist| 等命令来查看其
- 它的匹配。
- 5.2 配合 id-utils 使用 :grep
- 你可以设定 :grep 来使用 GNU id-utils:
- :set grepprg=lid\ -Rgrep\ -s
- :set grepformat=%f:%l:%m
- 然后:
- :grep (regexp)
- 就像你所期望的那样。
- (只要你记得首先 mkid :)
- 5.3 用 :grep 浏览源代码
- 使用 Vim 保存的错误列表，你可以查找某些函数或是其调用的其它函数。举个例子，如
- 果你要对read_file 函数添加一个参数，可以输入下面的命令:
- :grep read_file *.c
- 你可以用 ":cn" 在一系列匹配中跳转，然后加上所需要的参数。在某个地方，你需要从
- 上层函数 msg() 得到这个新的参数，并要对它做出修改:
- :grep msg *.c
- 在修改 msg() 函数的同时，你又找到另一个需要从上层函数中获得该参数的函数。你可
- 以用 ":grep" 命令找到这些函数。当完成一个函数后，你可以用:
- :colder
- 来跳转到上一个函数。
- 这就像浏览一个树一样，":grep" 每深入一层，就创建新的分支。":colder" 跳转到上
- 一层。你可以混和使用 ":grep" 和 ":colder" ，以树型方式来浏览所有的位置。如果
- 经常这么做，你不需写一个 "todo" 列表就能找到所有的位置。
- 6. 选择编译器 *compiler-select*
- *:comp* *:compiler*
- :comp[iler] {name} 为 {name} 编译器设定相关选项。
- {如编译时没指定 |+eval|，则此命令不可用}
- 这个命令实际上做的是：
- - 删除 "current_compiler" 变量 *current_compiler*
- - 执行 ":runtime! compiler/{name}.vim"
- 如要编写编译器插件，请参考 |write-compiler-plugin|。
- MANX AZTEC C *quickfix-manx* *compiler-manx*
- 要使 Vim 和 Amiga 上的 Manx Aztec C 编译器工作，需要以下步骤：
- - 设定 CCEDIT 环境变量：
- mset "CCEDIT=vim -q"
- - 用 -qf 选项编译。如果编译器发现任何错误，Vim 被启动，光标定位在首个错误处。
- 错误信息会在最后一行显示。你可以用上面提到的命令跳转到其它的错误，对其修定并
- 存盘。
- - 如果正常退出 Vim，编译器会再次编译相同文件。如果用 :cq 命令退出，编译器就会
- 终止。如果不能修定错误或是需要先编译其它的文件，你可以这样做。
- 在 Amiga 系统上，QuickFix 模式会有某些限止。编译器只能在错误文件中写入前 25 个
- 错误（Manx 的文档没有说明怎样才能写入更多）。如果想查找其它的错误，你需要首先
- 修定一些错误并退出编译器。重新编译后，剩下的错误 （最多 25 个）就会找到。
- 如果 Vim 是在编译器中启动的，:sh 和 一些 :! 命令不能工作，因为 Vim 是和编译器
- 在同一个进程中运行而 stdin （标准输入 ）也不在交互状态。
- PYUNIT 编 译 器 *compiler-pyunit*
- 这其实不是一个编译器，而是一个为 Python 语言而设的单元测试工具。
- 从版本 2.0 起，它就在标准的 Python 发布中。对老版本，你可以在这里获得:
- [url]http://pyunit.sourceforge.net[/url] 。
- 当你运行测试时，Vim 会解析错误并进入到 quick-fix 模式。
- 不幸的是，没有一个运行测试的标准方法。
- 一般都会用使用 alltest.py。
- 有关 'makeprg' 选项就可以这样设定:
- setlocal makeprg=./alltests.py " Run a testsuite
- setlocal makeprg=python % " Run a single testcase
- 另外，参考 [url]http://vim.sourceforge.net/tip_view.php?tip_id=280.[/url]
- TEX 编 译 器 *compiler-tex*
- Vim 发布版本中的 Tex 编译器 ($VIMRUNTIME/compiler/tex.vim) 可以处理各种风格的
- TeX 格式。如果变量 b:tex_flavor 或 g:tex_flavor 存在，它将为 :make （即为所要
- 运行的命令）定义 TeX 风格；如果这两个变量都不存在，将会使用省缺的 "latex"。
- 比如，要编辑从 AMS-TeX 上 mypaper.tex \input-ed 而来的 chapter2.tex:
- :let b:tex_flavor = 'amstex'
- :compiler tex
- < [editing...]
- :make mypaper
- 注意，你须要将所处理文件的文件名作为参数（以在编辑 \input-ed 或 \include-ed
- 文件时能处理正确的文件）。这不是 make 的语义，但你可以指定不含扩展名 ".tex" 的
- 文件名。
- 使用到的变量:
- b:tex_ignore_makefile 或 g:tex_ignore_makefile
- 通常，如果当前目录存在 'Makefile' 或 'makefile' ，这将被视作用户想要用 make
- 处理 *TeX 文件的信号。如果你不想这样，可以在运行 :compiler tex 前设定上面的
- 两个变量之一。
- b:tex_flavor 或 g:tex_flavor
- 省缺的，编译器会认为你使用 LaTeX 并用 "latex" 运行它。如果你的情况不是这样，
- 可以将 b:tex_flavor 或 g:tex_flavor 设定为你所要运行的命令名。
- Note: latex 命令行格式对 MikTeX 和 teTeX 都适用。要使 :help errorformat-LaTeX
- 上的建议对不同 shell 不同 OS 都适用太过复杂，因此不允许使用其它的 TeX 的选项。
- 如果你的 TeX 不支持 "-interaction=nonstopmode"，请在命令行中用其它的方式表示
- \nonstopmode。
- 7. 错误格式 *error-file-format*
- *errorformat* *E372* *E373* *E374*
- *E375* *E376* *E377* *E378*
- 'errorformat' 选项指定可识别出的一系列格式。首个匹配的格式会被使用。你可以为编
- 译器产生的不同信息添加不同格式，或是为多个编译器添加项目。参见 |efm-entries|。
- 'errorformat' 里的每一项类似 scanf 的格式字符串。首先，你需要了解 scanf 是如何
- 工作的。请查看你的 C 编译器文档。下面你可以看到，Vim 理解 % 条目。其它的则无效。
- 'errorformat' 中的特殊字符是逗号和反斜杠，参见 |efm-entries|。注意实际字符 '%'
- 用 "%%" 来匹配，而不用反斜杠来转义。
- Note: 省缺忽略大小写差别。如果要匹配大小写，在模式中加入 "\C"，参见 |/\C|。
- 基 本 条 目
- %f 文件名 （字符串）
- %l 行号 （数字）
- %c 列号 （代表错误中字符列的数字，（一个 <tab> 等于一个
- 字符列））
- %v 实际列号 （代表错误中屏幕列的数字，（一个 <tab> 等于
- 8 个屏幕列））
- %t 错误类型 （单个字符）
- %n 错误号 （数字）
- %m 错误信息 （字符串）
- %r 匹配"余下的"的单行文件信息 %O/P/Q
- %p 指针行 （'-', '.' 或是 ' ' 的序列，用长度作为列号）
- %*{conv} 任何 scanf 非指定转换
- %% 单个 '%' 字符
- "%f" 转换倚赖于当前 'isfname' 的设定。
- "%f" 和 "%m" 转换需要识别字符串结尾。它们后面可跟一个不能在字符串中出现的字
- 符，在此之前的所有字符都包括在字符串中。但当下一个字符是 '%' 或是反斜杠，"%f"
- 会查找任何 'isfname' 字符，而 "%m" 则查找任意。如果 "%f" 或 "%m" 在结尾，则行
- 中此前的所有字符都被包括。
- 在 MS-DOS, MS-Windows 和 OS/2 系统上，"C:" 会加到 "%f" 开头中，即使使用
- "%f:"。这就是说单字符（字母表中）文件名别将不被识别。
- "%p" 转换一般后跟 "^"。这是为了编译器产生的这种输出:
- ^
- or
- ---------^
- 以指定错误所在列。这被用在一个多行错误信息中。一个有用的列子，参见
- |errorformat-javac|。
- 改 变 目 录
- 下面的大写转换指定特殊格式化字符串的类型。它们大多作为以逗号分隔的单个格式的
- 前缀。
- 一些编译器产生含有目录名的信息，这些目录名需要加在 %f 读入文件名的前面 (比如
- GNU make)。下面的的代码可用于扫描这些目录名；它们将被保存在内部的目录栈中。
- *E379*
- %D "进入目录" 格式字符串；期待后跟 %f 以找到目录名
- %X "离开目录" 格式字符串；期待后跟 %f
- 当定义 "进入目录" 或是 "离开目录" 格式时，"%D" 或是 "%X" 需要在字符串的开头。
- Vim 跟踪记录变化并把当前目录加在错误文件的相对目录中。有关细节，参见
- |quickfix-directory-stack|。
- 多 行 信 息 *errorformat-multi-line*
- 可以读入程序输出的多行信息，比如，错误字符超过一行。有关前缀有:
- %E 错误信息开始
- %W 警告信息开始
- %I 一般信息开始
- %A 多行信息开始 (未指定类型)
- %C 多行信息继续
- %Z 多行信息结束
- 这些可同 '+' 和 '-' 一起使用，参见下面的 |efm-ignore|。
- 例子: 你的编译器以下面格式输出 (开头的行号并不是实际输出):
- 1 Error 275
- 2 line 42
- 3 column 3
- 4 ' ' expected after '--'
- 正确的错误格式串应如下:
- :set efm=%EError\ %n,%Cline\ %l,%Ccolumn\ %c,%Z%m
- 这样， |:clist| 产生的出错信息为:
- 1:42 col 3 error 275: ' ' expected after '--'
- 另一个例子: Python 解释器产生下面的错误信息 (行号不是实际输出):
- 1 ==============================================================
- 2 FAIL: testGetTypeIdCachesResult (dbfacadeTest.DjsDBFacadeTest)
- 3 --------------------------------------------------------------
- 4 Traceback (most recent call last):
- 5 File "unittests/dbfacadeTest.py", line 89, in testFoo
- 6 self.assertEquals(34, dtid)
- 7 File "/usr/lib/python2.2/unittest.py", line 286, in
- 8 failUnlessEqual
- 9 raise self.failureException, \
- 10 AssertionError: 34 != 33
- 11
- 12 --------------------------------------------------------------
- 13 Ran 27 tests in 0.063s
- 假使你想让 |:clist| 输出这样的相关信息:
- 5 unittests/dbfacadeTest.py:89: AssertionError: 34 != 33
- 错误格式字符串可这样定义:
- :set efm=%C\ %.%#,%A\ \ File\ "%f"\\,\ line\ %l%.%#,%Z%[%^\ ]%\\@=%m
- 注意 %C 字符串在 %A 前指定: 因为 ' %.%#' 表达式（表示正则表达式 ' .*'）匹配每
- 一个以空格开头后接任何字符的行，这样就包括可以单独产生错误信息的第 7 行。错误
- 格式字符串总是一个模式接一个模式的分析，直到找到首个匹配。
- 单 独 文 件 名 *errorformat-separate-filename*
- 如果编译器输出只给定一次文件名而有多个信息指向这个文件，下面的前缀就很有用:
- %O 单行文件信息: 再次读入匹配部分。
- %P 单行文件信息: 将 %f 入栈
- %Q 单行文件信息: 将最后一个文件名出栈
- 例子: 编译器产生以下出错日志 （不含开头的行号）:
- 1 [a1.tt]
- 2 (1,17) error: ';' missing
- 3 (21,2) warning: variable 'z' not defined
- 4 (67,3) error: end of file found before string ended
- 5
- 6 [a2.tt]
- 7
- 8 [a3.tt]
- 9 NEW compiler v1.1
- 10 (2,2) warning: variable 'x' not defined
- 11 (67,3) warning: 's' already defined
- 这个文件对每个在 [...] 中包括的文件列出了多个信息。我们可以这样设定格式：
- :set efm=%+P[%f],(%l\\,%c)%*[\ ]%t%*[^:]:\ %m,%-Q
- |:clist| 会正确的显示它们的文件名:
- 2 a1.tt:1 col 17 error: ';' missing
- 3 a1.tt:21 col 2 warning: variable 'z' not defined
- 4 a1.tt:67 col 3 error: end of file found before string ended
- 8 a3.tt:2 col 2 warning: variable 'x' not defined
- 9 a3.tt:67 col 3 warning: 's' already defined
- 和其它匹配整行的前缀不同，%P, %Q 和 %O 可以匹配同一行中的多个模式。这样就可以
- 对像下面这样套嵌的文件解析：
- {"file1" {"file2" error1} error2 {"file3" error3 {"file4" error4 error5}}}
- %O 解析不含 入栈/出栈 信息的字符串。更深入的例子，参见 |errorformat-LaTeX|。
- 忽 略 和 使 用 整 个 信 息 *efm-ignore*
- '+' 和 '-' 可与上面的大写代码接合；这种情况下，它们要在字母的前面，比如 '%+A'
- 或 '%-G'。
- %- 不在任何输出中包含相匹配的多行
- %+ 在 %m 错误串中包含真个匹配行
- %G 只在和 '+' 和 '-' 接合使用时才有用。它会解析编译器版本等可被忽略的字符串。
- %-G 忽略此信息
- %+G 通用信息
- 模 式 匹 配
- scanf() 类 "%*[]" 记法仍被支持，以和老版本兼容。但你可以在格式化字符串中指定
- Vim 支持的（几乎）任何正则表达式。元字符本身可能为匹配字符串或文件名的一部分
- （因此需要被转义），它们开头都加上一个 '%'：
- %\ 单个 '\' 字符。注意在 ":set errorformat=" 定义中需要
- 用 "%\" 来转义。
- %. 单个 '.' 字符。
- %# 单个 '*'(!) 字符。
- %^ 单个 '^' 字符。
- %$ 单个 '$' 字符。
- %[ 单个 '[' 字符 （指定一个 [] 字符范围）。
- %~ 单个 '~' 字符。
- 当在表达式中使用字符类（参见 |/\i|）时，含有 "\+" 数量符的串可以使用 scanf()
- 的 "%*" 形式。比如: "%\\d%\\+" ("\d\+", "任意数字") 和 "%*\\d" 相同。
- Note: 子匹配 \(...\) 不能用于格式指定中，因为它被留作内部变换使用。
- 'errorformat' 中 的 多 个 选 项 *efm-entries*
- 为能识别从不同编译器产生的输出，可在 'errorformat' 中指定多个格式模式，用逗号
- 将它们分隔 (note: 逗号后的空格被忽略)。第一个完全匹配的模式被使用。如果没有匹
- 配，则使用最后一个模式中匹配的部分，虽然文件名被删除并且错误信息被设定为整个信
- 息。如果有模式可以匹配多个编译器产生的输出（但不是正确的方式），将它放到一个更
- 严格的模式的后面。
- 要在模式中包括逗号，在它前面加一个反斜杠（如果是在 ":set" 命令中，要加两个）。
- 要包括反斜杠本身，则使用两个反斜杠（在 ":set" 命令中使用四个）。":set" 命令中，
- 在空格前也要加一个反斜杠。
- 有 效 匹 配 *quickfix-valid*
- 如果某行不能完全匹配 'errorformat' 中的项目，则此行被放入到错误信息中并标记为
- "无效"。这些行会被 ":cn" 和 ":cp" 命令忽略（除非没有任何有效行存在）。你可以
- 用 ":cl!" 来显示所有的出错信息。
- 如果出错格式不含文件名，Vim 不能跳转到正确的文件。你需要手动跳转。
- 例子
- Aimga 上的 Aztec 编译器产生的错误文件格式是:
- filename>linenumber:columnnumber:errortype:errornumber:errormessage
- filename 错误所在文件的文件名
- linenumber 错误所在行号
- columnnumber 错误所在列号
- errortype 错误类型，一般为 'E' 或 'W'
- errornumber 错误号
- errormessage 错误描述
- 可以用这个 'errorformat' 项目来匹配:
- %f>%l:%c:%t:%n:%m"
- 一些对产生单行错误输出的编译器的例子:
- %f:%l:\ %t%*[^0123456789]%n:\ %m Manx/Aztec C 出错信息
- (scanf() 不能理解 [0-9])
- %f\ %l\ %t%*[^0-9]%n:\ %m SAS C
- "%f"\\,%*[^0-9]%l:\ %m 一般 C 编译器
- %f:%l:\ %m GCC
- %f:%l:\ %m,%Dgmake[%*\\d]:\ Entering\ directory\ `%f',
- %Dgmake[%*\\d]:\ Leaving\ directory\ `%f'
- 与 gmake 接合的 GCC (同一行)
- %f(%l)\ :\ %*[^:]:\ %m 旧的 SCO C 编译器 (pre-OS5)
- %f(%l)\ :\ %t%*[^0-9]%n:\ %m 同上，增加错误类型和错误号
- %f:%l:\ %m,In\ file\ included\ from\ %f:%l:,\^I\^Ifrom\ %f:%l%m
- GCC，一些附加信息
- 对多行信息处理更深入的例子，参见 |errorformat-Jikes| 和 |errorformat-LaTeX|.
- 注意在空格和引号前的反斜杠。这对 :set 命令是必须的。在逗号前有两个反斜杠，一个
- 是为 :set 命令须要，一个是为避免将逗号视为出错格式的分隔符。
- 过 滤 信 息
- 如果编译器产生的错误信息和格式串不适合，你可以写一个程序将出错信息转化为适合格
- 式。通过设定 'makeprg' 选项，你可以用 ":make" 命令运行它。比如:
- :set mp=make\ \\\|&\ error_filter
- 管道符前的那些反斜杠是为了避免将其视作命令分隔符。每个空格前的反斜杠是 :set
- 命令所必须的。
- 8. 目录栈 *quickfix-directory-stack*
- Quickfix 根据 make 输出，维护一个保存所有使用过的目录的栈。对 GNU-make 来讲，
- 这非常简单，因为它总是输出绝对路径，即使是通过 makefile 中的一个 'cd' 命令或以
- "-C dir" (在读入 makefile 之前进入到指定目录) 参数运行。'-w' 选项可用来强制
- GNU-make 在处理前后输出当前目录。
- 如果你使用的不是 GNU-make，那目录栈的维护就会复杂得多。比如 AIX-make 从不输出
- 有关当前目录的任何信息。这样你就需要在 makefile 上多花些功夫。lesstiff 的
- makefile 中有一个命令可以显示 "Making {target} in {dir}"。这里的问题是它并不在
- 离开目录时输出信息，而且它不输出绝对路径。
- 为解决相对路径和缺少 "leave direcotry" 信息问题，Vim 使用下面的算法:
- 1) 检查给定目录是否为当前目录的子目录。如是，则将其存为当前目录。
- 2) 如果不是，则检查它是否为上级目录的子目录。
- 3) 如果目录仍没找到，则假定为它为 Vim 当前目录的子目录。
- 例外，每一个文件都被检查，看其是否存在于识别出的目录中。如果不存在，则在目录栈
- （不是目录树）的其它目录中查找。如果仍没找到，则假定它在 Vim 当前目录中。
- 此算法仍有限制。本例假定 make 在进入到一个目录时输出类似 "Making all in dir"
- 的信息。
- 1) 假定你有以下目录和文件:
- ./dir1
- ./dir1/file1.c
- ./file1.c
- 如果 make 在处理当前目录前处理 "./dir1" 目录，而在 文件 "./file1.c" 中存在
- 一处错误，Vim 会载入文件 "./dir1/file.c"。
- 这只能靠 "leave direcotry" 信息解决。
- 2) 假定你有以下目录和文件:
- ./dir1
- ./dir1/dir2
- ./dir2
- 你得到如下结果:
- Make 输出 Vim 理解的目录
- ------------------------ ----------------------------
- Making all in dir1 ./dir1
- Making all in dir2 ./dir1/dir2
- Making all in dir2 ./dir1/dir2
- 这可以通过在 "enter directory" 信息中输出绝对路径或是输出 "leave direcotry"
- 信息的方法解决。
- 为避免这些问题，要确保输出绝对路径和 "leave directory" 信息。
- Makefiles 例子:
- Unix:
- libs:
- for dn in $(LIBDIRS); do \
- (cd $$dn; echo "Entering dir '$$(pwd)'"; make); \
- echo "Leaving dir"; \
- done
- 并将
- %DEntering\ dir\ '%f',%XLeaving\ dir
- 加到 'errorformat' 选项中以处理上面的输出
- 注意 Vim 并不检查 "leave directory" 信息中的目录是否为当前目录。因此你可使用
- "Leaving dir" 信息。
- 9. 特定错误格式 *errorformats*
- *errorformat-Jikes*
- Jikes(TM), IBM Research 发布的一个 source-to-bytecode Java 编译器提供简单的多
- 行信息。
- 一个和产生的信息相匹配的格式字符如下所示。
- 这面这几行可加到用户的 |vimrc| 以覆盖 Vim 识别的省缺模式。或者，你可以参考
- |:set+=| 将这个模式加入到省缺中。
- :set efm=%A%f:%l:%c:%*\\d:%*\\d:,
- \%C%*\\s%trror:%m,
- \%+C%*[^:]%trror:%m,
- \%C%*\\s%tarning:%m,
- \%C%m
- 以 "+E" 选项启动时，Jikes(TM) 产生一个单行信息。对此，可以这样匹配：
- :set efm=%f:%l:%v:%*\\d:%*\\d:%*\\s%m
- *errorformat-javac*
- 'errorformat' 可以很好的和 javac 工作，javac 的输出中用 "^" 表示错误所在列:
- :set efm=%A%f:%l:\ %m,%-Z%p^,%-C%.%#
- 或者:
- :set efm=%A%f:%l:\ %m,%+Z%p^,%+C%.%#,%-G%.%#
- *errorformat-ant*
- ant ([url]http://jakarta.apache.org/[/url]) 输出的每个行首都为 [javac]，这样我们可将上面
- 的格式修改如下:
- :set efm=%A\ %#[javac]\ %f:%l:\ %m,%-Z\ %#[javac]\ %p^,%-C%.%#
- 'errorformat' 还可以处理 ant 和 javac 或是 jikes 的接合。如使用 jikes, 你需要
- 告诉 ant 使用 jikes 的 +E 选项以使 jikes 产生单行错误信息。
- （一个 build.xml 文件的）第二行如下所示：
- <property name = "build.compiler" value = "jikes"/>
- <property name = "build.compiler.emacs" value = "true"/>
- 'errorformat' 同时处理 ant 与 javac 和 jikes:
- :set efm=\ %#[javac]\ %#%f:%l:%c:%*\\d:%*\\d:\ %t%[%^:]%#:%m,
- \%A\ %#[javac]\ %f:%l:\ %m,%-Z\ %#[javac]\ %p^,%-C%.%#
- *errorformat-jade*
- 解析 jade (see [url]http://www.jclark.com/[/url]) 错误十分简单:
- :set efm=jade:%f:%l:%c:%t:%m
- *errorformat-LaTeX*
- 下面是 'errorformat' 处理 (La)Tex 产生的多行错误输出的例子。":clist" 和 ":cc"
- 等命令将多行错误信息显示在一行，开头的空格被删除。
- 将 LaTeX 的错误格式运用于其它产生多行错误信息的编译器就很简单了。
- 命令可被加到 |vimrc| 或是其它 Vim 脚本，比如一个在编辑 LaTeX 源文件时载入的
- 含有 LaTeX 相关东西的脚本。
- 确定将例子中的所有行都拷贝，然后可删除注释行。对一些行中开头的 '\'，参考
- |line-continuation|.
- 首先设定 'makeprg' 使 LaTeX 可以报多行错；且在首个错误发生时
- 不停止:
- :set makeprg=latex\ \\\\nonstopmode\ \\\\input\\{$*}
- 多行错误信息开始:
- :set efm=%E!\ LaTeX\ %trror:\ %m,
- \%E!\ %m,
- 多行警告信息开始；开始的两个包含行号。一些正则表达式的意义：
- - "%.%#" (".*") 匹配一个可为空的字符串
- - "%*\\d" ("\d\+") 匹配一个数字
- \%+WLaTeX\ %.%#Warning:\ %.%#line\ %l%.%#,
- \%+W%.%#\ at\ lines\ %l--%*\\d,
- \%WLaTeX\ %.%#Warning:\ %m,
- < 错误/警告信息继续；首个含有行号：
- \%Cl.%l\ %m,
- \%+C\ \ %m.,
- \%+C%.%#-%.%#,
- \%+C%.%#[]%.%#,
- \%+C[]%.%#,
- \%+C%.%#%[{}\\]%.%#,
- \%+C<%.%#>%.%#,
- \%C\ \ %m,
- < 匹配下面模式的行不含有任何重要的信息；将其忽略:
- \%-GSee\ the\ LaTeX%m,
- \%-GType\ \ H\ <return>%m,
- \%-G\ ...%.%#,
- \%-G%.%#\ (C)\ %.%#,
- \%-G(see\ the\ transcript%.%#),
- < 删除所有空白行:
- \%-G\\s%#,
- LaTeX 输出并不在每一行中都指定出错的文件名；而只在括号中指定
- 一次。
- 下面的模式试图匹配这些文件名并将它们保存到内部栈中。这些模式
- 可能扫描相同行（一个接一个的），结尾的 "%r" 表示 行中 "余下"
- 的部分，以在下轮被解析，直到行尾。
- 再次读入 '('...')' 包含的文件名；这并不将其入栈，因为此文件
- 不含有任何错误:
- \%+O(%f)%r,
- < 将 '(' 后的文件名入栈:
- \%+P(%f%r,
- \%+P\ %\\=(%f%r,
- \%+P%*[^()](%f%r,
- \%+P[%\\d%[^()]%#(%f%r,
- < 当扫描到 ')', 将最后一个文件名出栈:
- \%+Q)%r,
- \%+Q%*[^()])%r,
- \%+Q[%\\d%*[^()])%r
- 注意某些情况下，LaTeX 输出中的文件名不能正确解析。解析会被不成对的括号打乱。
- 上面的例子只试图捕获最普通的情况。你可以根据你的需要而修改有关设定，比如，
- 所有烦人的 "Overfull ..." 警告可不被视为出错。
- 除了过滤 LaTeX 的输出信息外你还可以直接读入 [La]TeX 编译器生成的 *.log 文件。
- 这包括其它的一些由错误引起的有用信息。但要解析这么复杂的文件，你需要使用外部
- 过滤器。参考上面关于 Vim 过滤器的描述。
- *errorformat-Perl*
- 在 $VIMRUNTIME/tools 中，你可以找到 efm_perl.pl 脚本。它将 Perl 出错信息过滤
- 为 quickfix 模式的可懂格式。关于怎样使用它，查看该文件的开头部分。
- vim:tw=78:ts=8:ft=help:norl:
- Generated by vim2html on Wed Jun 23 16:04:39 IST 2004
|
|
IP卡
狗仔卡
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
显身卡