如何在运行Python脚本前自动执行Black，同时保留Python完整命令行功能？

前置条件 #

确保已安装Black：

pip install black

VIM配置实现 #

在你的VIM配置文件（~/.vimrc 或 Neovim 的 ~/.config/nvim/init.vim）中添加以下配置：

" 自定义命令：运行Python前先执行Black语法检查，支持任意命令行参数
command! -nargs=* RunPy call RunPythonWithBlack(<f-args>)

function! RunPythonWithBlack(...)
  " 自动保存当前文件，避免检查旧内容
  silent write
  " 执行Black检查（仅验证有效性，不修改文件）
  let black_output = system('black --check ' . shellescape(expand('%')))
  if v:shell_error != 0
    " 检查失败时输出错误信息
    echoerr "Black检查未通过：\n" . black_output
  else
    " 检查通过，拼接Python运行命令并执行
    let py_cmd = 'python ' . shellescape(expand('%')) . ' ' . join(a:000, ' ')
    echo "正在运行：" . py_cmd
    " 用终端窗口运行，支持实时输出和交互
    execute 'term ' . py_cmd
  endif
endfunction

" 映射F5快捷键，快速调用RunPy命令
nnoremap <F5> :RunPy<Space>

使用方法 #

1. 快捷键方式：打开Python脚本后按 <F5>，光标会停在命令行末尾，直接输入需要传递的参数（比如 --debug input.txt），回车即可运行。
2. 命令方式：直接在VIM命令行输入 :RunPy arg1 arg2 ...，回车执行。

关键细节说明 #

• black --check：仅检查代码是否为有效Python且符合Black规范，不会修改你的代码，适合前置验证场景。
• shellescape：自动转义文件名和参数中的空格、特殊字符，避免命令执行出错。
• term 命令：用VIM内置终端运行脚本，可查看实时输出，也支持交互式脚本的输入操作。
• -nargs=*：让自定义命令支持接收任意数量的参数，完全保留Python的命令行参数传递能力。

注意事项 #

如果虚拟机使用了Python虚拟环境，确保VIM能访问到安装了Black的Python环境——可在VIM中运行 :!which black 确认路径是否正确，或者在配置中指定Black的完整路径（比如 /home/user/venv/bin/black）。

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