dispatch.vim
利用 Vim 编译器插件的强大功能,而不受同步性的限制。使用多种异步适配器(包括 tmux、screen、iTerm、Windows 和无头模式)来启动构建和测试套件,当任务完成时,错误将自动加载和解析。
如果这还不能让你兴奋,那么也许这个视频能改变你的想法。
安装
使用你喜欢的包管理器安装,或使用 Vim 内置的包支持:
mkdir -p ~/.vim/pack/tpope/start
cd ~/.vim/pack/tpope/start
git clone https://tpope.io/vim/dispatch.git
vim -u NONE -c "helptags dispatch/doc" -c q
使用方法
Vim 编译器系统的核心是 :make
命令,类似于 :grep
,它运行构建工具并解析结果错误。默认的构建工具当然是 make
,但你可以用 :compiler
切换它(以及相关的错误解析器)。有很多内置的编译器,它们不仅仅用于编译。你还可以创建自己的编译器。
我们先来看看 dispatch.vim 的 :make
包装器 :Make
,然后再讨论更高级的抽象。
前台构建
使用 :Make
启动快速任务。接下来发生的事情取决于哪个适配器接管。
- 如果你在 tmux 中,底部会打开一个小分割窗口。
- 在 Windows 上,会生成一个最小化的 cmd.exe 窗口。
- 否则,你会得到一个普通的
:make
调用。
当任务完成时,窗口关闭,错误被加载和解析,quickfix 窗口自动打开。在整个过程中,你的焦点不会被抢走。
后台构建
对于运行时间较长的任务,如"运行整个测试套件",请使用 :Make!
。
- 如果你在 tmux 或 GNU screen 中,会在后台创建一个新窗口。
- Windows 仍然会生成一个最小化的 cmd.exe 窗口。
- 否则,你会得到一个无头调用。你看不到它,但它在后台运行。
对于后台构建,你不会被 quickfix 窗口打断。相反,你可以在方便的时候用 :Copen
打开它。
你也可以对仍在运行的构建使用 :Copen
来检索和解析已经发生的任何错误。
切换编译器
如前所述,切换编译器很容易。
:compiler rubyunit
:make test/models/user_test.rb
等等,这仍然是需要的命令数量的两倍。而且,它要求你从 testrb
(可执行文件)联想到 rubyunit
(编译器插件)。:Dispatch
命令会为可执行文件寻找编译器并自动设置。
:Dispatch testrb test/models/user_test.rb
如果没有找到编译器插件,:Dispatch
简单地捕获所有输出。
:Dispatch bundle install
与 :make
一样,你可以使用 %
扩展来表示当前文件名。
:Dispatch rspec %
:Dispatch
命令之后会切换回编译器,所以你可以为 :Make
选择一个主要编译器,并使用 :Dispatch
处理次要问题。
默认调度
不带参数时,:Dispatch
会查找 b:dispatch
变量。你可以交互式设置它,或在自动命令中设置:
autocmd FileType java let b:dispatch = 'javac %'
如果没有找到 b:dispatch
,它会回退到 :Make
。
:Dispatch
是一个很好的映射。默认情况下,dispatch.vim 提供 `<CR>
作为 :Dispatch<CR>
的映射。你可以在 :h dispatch-maps
下找到所有默认映射。
聚焦
使用 :FocusDispatch
(或简单的 :Focus
)来临时全局覆盖默认调度:
:Focus rake spec:models
现在每次裸调用 :Dispatch
都会调用 :Dispatch rake spec:models
。你会经常使用那个 :Dispatch
映射。
使用 :Focus!
重置回默认值。
生成交互式进程
有时你只想启动一个进程,而不需要任何输出捕获或错误解析。这就是 :Start
的用途:
:Start lein repl
与 :Make
不同,新窗口将获得焦点,因为你可能想与之交互。使用 :Start!
在后台启动它。
插件支持
从插件中使用 dispatch.vim 很简单,只需检查并使用 :Make
和 :Start
(如果可用),而不是 :make
和 :!
。你最喜欢的插件已经支持它了,假设你最喜欢的插件是 rails.vim。
常见问题
如何让
:Dispatch!
或:Make!
在完成时打开 quickfix 窗口?
使用 :Dispatch
或 :Make
。使用 !
的全部意义在于在后台运行而不打扰你。
但那会阻塞 Vim。
那么使用的适配器不支持前台构建。调整你的设置。
自我推广
喜欢 dispatch.vim 吗?在 GitHub 上关注这个仓库,并在 vim.org 上为它投票。如果你特别慷慨,可以在 Twitter 和 GitHub 上关注 tpope。
许可证
版权所有 © Tim Pope。在与 Vim 本身相同的条款下分发。
请参阅 :help license
。