Neovim 如何用 quickfix 列表在编译错误间逐个跳转并修改【免费下载链接】neovimVim-fork focused on extensibility and usability项目地址: https://gitcode.com/GitHub_Trending/ne/neovim编译一个 C 项目时终端里往往刷出一长串file.c:12: error: ...。逐个复制文件名和行号再打开文件既慢又容易漏。Neovim 内置的 quickfix快速修复模式就是为编辑—编译—修改这个循环设计的它把编译器输出解析成一个错误列表你可以打开列表窗口查看全部问题然后逐条跳转到出错位置修改修完再重新编译验证。本文基于仓库内 quickfix 帮助文档 和 gcc 编译器插件 的说明走通这条完整的操作路径。适用前提是你在项目目录里有一个可用的构建命令下文以 make/gcc 为例。先让 Neovim 认识你的编译器输出quickfix 靠errorformat选项把输出文本解析成文件 行号 列号 错误信息的条目。格式项用类似 scanf 的%f文件名、%l行号、%c列号、%m错误文本等标记描述多个格式以逗号分隔第一个完整匹配某行输出的格式生效详见 quickfix.txt 第 7 节。大多数常用编译器不必手写格式直接用:compiler加载对应插件即可。以 gcc 为例在 Neovim 中执行:compiler gcc这会加载 runtime/compiler/gcc.vim通过CompilerSet设置一组 gcc 的errorformat模式例如能匹配%f:%l:%v:文件:行:列形式的 error/warning也能匹配 make 的Entering/Leaving directory目录切换行。无!时选项只对当前 buffer 生效:compiler! gcc则设为全局。插件只负责设置errorformat等选项要执行的构建命令由makeprg选项决定其默认值就是make所以 make 项目可以直接进入下一步。如果你的编译器不在插件列表里就按 quickfix.txt 第 7 节的格式项说明手动:set errorformat...使每条错误都能被解析出文件名和行号。用 :make 编译并跳到第一个错误在项目根目录、已打开任意一个源文件的 buffer 中执行:make:make的实际流程quickfix.txt 第 4 节触发QuickFixCmdPreautocommand若autowrite打开先写出已修改的 buffer由makeef生成一个错误文件启动makeprg指定的程序默认make输出存入错误文件Unix 上同时回显到屏幕用errorformat解析错误文件建立 quickfix 列表触发QuickFixCmdPost未加!时自动跳到第一个错误。跳过去之后光标就停在第一个错误的行上直接修改。:make后面可以直接跟参数作为构建参数例如:make -j4注意该命令不接受注释之后的内容都算参数。:make!只建列表不跳转。如果编译器输出编码和encoding不一致导致列表文本乱码文档给出的做法是用makeencoding指定编码或在QuickFixCmdPost make中用iconv()转换quickfix.txt 中有完整的 Vim 函数示例。打开错误窗口查看全部错误:copen错误窗口默认 10 行、位于屏幕底部winfixheight已设置高度基本保持不变。窗口里每行一条错误默认显示格式为filename|lnum col col|text当前正在查看的条目用QuickFixLine高亮。窗口内容是buftypequickfix的特殊 buffer不要手动改动其中文本——行号与错误序号的对应关系会乱若确实想按文本筛选文档建议把内容写到文件再用:cfile重新解析。在错误窗口里光标停在某行按Enter、双击鼠标或执行:.cc都会跳到该行对应的错误:clist在命令区列出所有有效条目支持范围如:clist 3,8:clist!列出全部行包括未被errorformat完整匹配、因此被标记为 not valid 的行——:cnext/:cprevious会自动跳过这些无效行用:clist!能看出哪些输出没被解析。窗口不再需要时用:cclose关闭。用 :cnext、:cprevious 和 [q / ]q 在错误间逐个跳转修完当前错误后按下面这些命令推进列表[count]前缀可以一次跳多条命令作用:cnext简写:cn跳到下一条错误默认映射键]q:cprevious简写:cp跳到上一条错误默认映射键[q:cfirst/:clast跳到第一条 / 最后一条映射键[Q/]Q:cc N跳到第 N 条错误省略 N 则重新显示当前条目:cnfile/:cpfile跳到下一个 / 上一个文件中的第一条错误:ccrewind同:cfirst[q和]q是 Neovim 的默认映射normal 模式下直接按即可不用每次敲:cnext。:cnfile/:cpfile适合错误集中在某几个文件时按文件推进。两点与 buffer 切换相关的限制值得注意跳到另一个文件的错误时若当前 buffer 有未保存修改、且hidden和autowrite都未开跳转会被拒绝加!如:cn!会放弃当前 buffer 的修改除非hidden已设置或该 buffer 还有别的窗口。:cc有同样的说明。想在新窗口里查看某条错误而不占用当前窗口在错误窗口中用CTRL-W Enter。修完所有错误后进入验证环节。修改后再编译用 :cwindow 确认列表已清空回到源文件改完后重新执行:make。新的错误列表会立即成为当前列表旧的列表并没有被丢弃每次:make、:grep等建立的列表都按chistory保留在栈中可以用下面的命令往返:colder 回到上一份更旧的错误列表 :cnewer 回到更新的错误列表 :chistory 列出所有错误列表当前列表以 标记验证修复是否彻底:cwindow:cwindow的语义是列表中有被识别到的错误就打开错误窗口窗口已打开且已没有识别到的错误时关闭它。所以修完错误后重跑:make若:cwindow把错误窗口关掉了说明本次编译输出中已经没有能匹配errorformat的条目。也可以直接:clist查看——列表为空即表示当前编译无匹配错误。若列表里还剩条目cnext逐条处理即可。另一条入口错误文件已存在时文档说明的起点是错误消息已经在一个文件里。两种用法nvim -q errors.txt-q [errorfile]是 QuickFix 启动模式启动时读取该文件并直接显示第一个错误starting.txt。未指定文件时用errorfile选项的值。如果 Neovim 已经开着用命令读入错误文件:cfile errors.txt 读取并跳到第一个错误 :cgetfile errors.txt 只读取不跳转 :caddfile errors.txt 追加到当前 quickfix 列表:cfile同样按errorformat解析所以编译器非标准输出依然要先调好格式项解析不出的行会成为无效条目可用:clist!检查。限制与边界必须解析出文件名才能自动跳转若某条错误没匹配到含文件名和行号的格式Vim 无法切到正确文件只能手动打开quickfix.txt Valid matches 一节。这类条目会被:cn/:cp跳过。多行错误需要专门的格式前缀%E/%W/%C/%Z等前缀用来描述跨多行的消息%D/%X用于处理 make 的进目录/出目录输出gcc 插件已包含这些模式手写errorformat时要参照第 7 节的规则。location list 是窗口级的同类列表:lmake、:lvimgrep等命令产生与 quickfix 独立的、绑定当前窗口的列表跳转命令是l前缀如:lnext、:lopen。本文路径全部用全局 quickfix 列表若你在多个窗口并行看不同文件的诊断可改用 location list操作方式与上文一一对应。文档中的:cc示例输出如8384 testje.java:252: error: cannot find symbol ~只是文档示例实际列表内容取决于你的编译输出。【免费下载链接】neovimVim-fork focused on extensibility and usability项目地址: https://gitcode.com/GitHub_Trending/ne/neovim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考