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。