自制另一个新的 Vim 8.0 专用异步插件:asyncrun.vim,它可以让你在 Vim 里面异步运行各种 Shell 指令并且把结果实时输出到 Quickfix,需要 Vim 7.4.1829 以上版本。
安装方法
到插件首页 https://github.com/skywind3000/asyncrun.vim 下载项目,并拷贝 asyncrun.vim
到你的 ~/.vim/plugin
。或者使用 Vundle 指向 skywind3000/asyncrun.vim
来自动更新。
基本教程
使用 gcc 异步编译当前文件:
:AsyncRun gcc % -o %< :AsyncRun g++ -O3 % -o %< -lpthread
该命令会在后台运行 gcc 并且把输出实时显示在 Quickfix 窗口,宏 %
代表当前文件名,%<
代表没有扩展名的文件名。
异步运行 make:
:AsyncRun make :AsyncRun make -f makefile
异步调用 grep:
:AsyncRun! grep -R word . :AsyncRun! grep -R <cword> .
默认 :AsyncRun 运行命令后,输出添加到 Quickfix时 Quickfix 会自动滚动到最下面那一行,使用感叹号修饰符以后,可以避免 Quickfix 自动滚动。同时 <cword>
代表当前光标下面的单词。
编译 go项目:
:AsyncRun go build %:p:h
宏 %:p:h
代表当前文件的目录
查询 man page,异步 git push ,以及把设置 F7异步编译当前文件:
:AsyncRun! man -S 3:2:1 <cword> :AsyncRun git push origin master :noremap <F7> :AsyncRun gcc % -o %< <cr>
使用手册
AsyncRun – Run shell command:
:AsyncRun{!} [cmd] ...
后台运行命令并且实时输出到 quickfix 窗口,如果有感叹号修饰符,quickfix 窗口的自动滚动将会禁止。
命令参数以空格分割,接受下面这些以 ‘%
‘, ‘#
‘ or ‘<
‘ 开头的替换宏:
%:p - File name of current buffer with full path %:t - File name of current buffer without path %:p:h - File path of current buffer without file name %:e - File extension of current buffer %:t:r - File name of current buffer without path and extension % - File name relativize to current directory %:h:. - File path relativize to current directory <cwd> - Current working directory <cword> - Current word under cursor <cfile> - Current file name under cursor
运行一个命令前,环境变量也会做如下设置:
$VIM_FILEPATH - File name of current buffer with full path $VIM_FILENAME - File name of current buffer without path $VIM_FILEDIR - Full path of current buffer without the file name $VIM_FILEEXT - File extension of current buffer $VIM_FILENOEXT - File name of current buffer without path and extension $VIM_CWD - Current directory $VIM_RELDIR - File path relativize to current directory $VIM_RELNAME - File name relativize to current directory $VIM_CWORD - Current word under cursor $VIM_CFILE - Current filename under cursor $VIM_GUI - Is running under gui ? $VIM_VERSION - Value of v:version $VIM_MODE - Execute via 0:!, 1:makeprg, 2:system() $VIM_COLUMNS - How many columns in vim's screen $VIM_LINES - How many lines in vim's screen
AsyncStop – Stop the running job:
:AsyncStop{!}
停止后台任务(使用 TERM信号),如果有感叹号修饰,则使用 KILL 信号结束
基本设置:
g:asyncrun_exit - 字符串,如果不为空那么任务结束时会被执行(VimScript) g:asyncrun_bell - 如果非零的话,任务结束后会响铃(终端输出控制符 \a) g:asyncrun_mode - 0:异步(需要 vim 7.4.1829) 1:同步 2:直接运行
全局变量:
g:asyncrun_code - 退出码 g:asyncrun_status - 状态 'running', 'success' or 'failure'
如果你喜欢的话请为我投一票:
http://www.vim.org/scripts/script.php?script_id=5431