如何在Neovim中创建绑定函数的:command自定义命令

完全可以，Vim/Neovim 原生支持通过:command自定义Ex命令，直接关联你封装的Vimscript/Lua函数，不需要额外插件。

1. 自定义命令绑定函数的基础规则 #

• 自定义命令使用command!关键字定义（加!表示重复加载配置时不会报命令已存在的错误），通过-nargs参数声明命令接收参数的规则，-nargs=*表示支持任意个参数，-nargs=+表示至少传1个参数。
• Vimscript 绑定函数最简示例：

  " 定义:MyCommand 命令，接收任意参数，调用自定义函数
  command! -nargs=* MyCommand call MyCustomFunc(<q-args>)
  function! MyCustomFunc(user_input)
      echo "你传入的内容是：" . a:user_input
  endfunction
  

  配置生效后输入:MyCommand 测试内容，就能触发对应函数逻辑。
• Neovim Lua 环境下可以直接用API创建命令，绑定Lua函数：

  vim.api.nvim_create_user_command('MyCommand', function(opts)
    print("你传入的内容是：" .. opts.args)
  end, { nargs = '*' })
  

注意：Vim/Neovim 强制要求用户自定义Ex命令必须以大写字母开头，无法直接定义以<这类符号开头的命令，可以通过命令行缩写实现近似:<的触发体验，后面会给出配置。

2. 「执行Shell命令并将输出插入光标位置」完整配置 #

你提到的redir方案可以实现，不过直接调用system()函数拿命令输出的写法更简洁，两种实现都给你：

兼容Vim/Neovim的Vimscript版本 #

把下面代码加到你的vimrc/init.vim里即可：

" 定义:ShellInsert 命令，接收shell命令作为参数，支持shell命令Tab补全
command! -nargs=+ -complete=shellcmd ShellInsert call InsertShellOutput(<q-args>)

function! InsertShellOutput(cmd)
    " 调用系统命令执行，拿到输出
    let shell_output = system(a:cmd)
    " 去掉输出末尾多余的换行
    let shell_output = substitute(shell_output, '\n$', '', '')
    " 拆分行
    let output_lines = split(shell_output, '\n')
    " 整行插入到当前光标所在行下方
    call append('.', output_lines)

    " 如果需要直接插入到光标所在的字符位置，把上面的append逻辑替换成下面这段
    " let cur_pos = getpos('.')
    " let cur_line = getline(cur_pos[1])
    " call setline(cur_pos[1], strpart(cur_line, 0, cur_pos[2]) . shell_output . strpart(cur_line, cur_pos[2]))
endfunction

" 配置命令缩写，输入:< 时自动替换为ShellInsert命令，实现你要的触发格式
cnoreabbrev <expr> < getcmdtype() == ':' && getcmdline() == '<' ? 'ShellInsert' : '<'

如果你一定要用redir的实现逻辑，把上面的InsertShellOutput函数替换成下面的版本即可：

function! InsertShellOutput(cmd)
    redir => shell_output
    silent execute '!' . a:cmd
    redir END
    " 去掉redir捕获的命令回显首行和末尾多余换行
    let shell_output = substitute(shell_output, '^.*\n', '', '')
    let shell_output = substitute(shell_output, '\n$', '', '')
    let output_lines = split(shell_output, '\n')
    call append('.', output_lines)
endfunction

Neovim专属Lua版本 #

用Lua写逻辑更简洁，加到init.lua即可生效：

vim.api.nvim_create_user_command('ShellInsert', function(opts)
  -- 执行shell命令拿输出
  local shell_output = vim.fn.system(opts.args)
  -- 清理末尾换行
  shell_output = shell_output:gsub('\n$', '')
  local output_lines = vim.split(shell_output, '\n')
  -- 整行插入光标下方
  vim.api.nvim_buf_set_lines(0, vim.api.nvim_win_get_cursor(0)[1], vim.api.nvim_win_get_cursor(0)[1], false, output_lines)
  -- 如果要直接内联插入到光标字符位置，把上面的插入逻辑替换为下面这行
  -- vim.api.nvim_put(output_lines, 'c', false, true)
end, {
  nargs = '+',
  complete = 'shellcmd' -- 支持Tab补全系统shell命令，和原生:!体验一致
})

-- 配置:< 触发缩写
vim.cmd([[cnoreabbrev <expr> < getcmdtype() == ':' && getcmdline() == '<' ? 'ShellInsert' : '<']])

使用说明 #

配置生效后，在普通模式输入:< ls -l（或者其他任意shell命令），回车后命令的输出就会直接插入到你当前光标所在位置。如果需要调整插入位置（比如插到光标上方、内联插到光标字符处），修改代码里的插入逻辑即可。

内容的提问来源于stack exchange，提问作者xihh