5月27日 14:01

Vim autocmd 自动命令怎么用？语法、事件和 augroup 怎么写？

为什么你需要 autocmd

改了半天配置，打开项目发现缩进又不对——每次手动 setlocal shiftwidth=4 也不现实。Vim 的 autocmd 就是为了解决这类"在特定时机自动执行特定操作"的需求而存在的。当你编辑不同类型的文件、保存文件、甚至启动 Vim 的瞬间，都可以让 Vim 替你完成预设动作。

autocmd 的基本语法

autocmd 的完整写法是：

vim
autocmd [group] {event} {pattern} [nested] {command}

逐个看：

group：可选，属于哪个命令组，后面会讲
event：触发时机，比如 BufRead、FileType
pattern：文件名匹配模式，比如 *.py、*.json，* 匹配所有文件
nested：可选，允许自动命令嵌套触发（默认 autocmd 执行中不会再触发其他 autocmd）
command：事件触发时要执行的 Vim 命令

一个最简单的例子：

vim
autocmd BufRead *.md setlocal spell

这行配置的意思是：每当打开一个 .md 文件，自动开启拼写检查。

常用事件一览

Vim 内置了上百个事件，日常用得最多的是这几个：

BufRead 和 BufReadPost

打开一个已存在的文件并读入缓冲区后触发。两者的区别在于 BufRead 在处理 modeline 之前触发，BufReadPost 在之后。绝大多数场景用 BufReadPost 就够了。

vim
autocmd BufReadPost *.xml setlocal matchpairs+=<:>

BufWritePre 和 BufWritePost

保存文件前和保存文件后触发。常见的用途是在保存前自动清理行尾空格：

vim
autocmd BufWritePre * :%s/\s\+$//e

FileType

当 filetype 选项被设置后触发。这是做语言专属配置最常用的事件，因为它是按文件类型匹配而非文件名：

vim
autocmd FileType python setlocal shiftwidth=4 tabstop=4 expandtab
autocmd FileType javascript setlocal shiftwidth=2 tabstop=2

比起按文件扩展名匹配，FileType 事件更可靠——Vim 的 filetype 机制会综合考虑文件名、shebang、文件内容来判断类型。

VimEnter

Vim 完成所有初始化工作后触发，适合做启动后的收尾操作：

vim
autocmd VimEnter * if !argc() | NERDTree | endif

这行让 Vim 在没有打开文件参数时自动打开目录树。

其他值得关注的事件

事件	触发时机
`BufNewFile`	新建文件时
`BufEnter`	进入缓冲区时
`InsertEnter`	进入插入模式时
`CursorHold`	光标停留一段时间不动后
`TextChangedI`	插入模式下内容变化时

多个事件可以用逗号合写：autocmd BufNewFile,BufRead *.vue setfiletype html。

augroup：给你的自动命令分组

直接写 autocmd 有个问题：如果你的 vimrc 被 source 了两次，同一组 autocmd 就会注册两遍。执行两遍 setlocal 倒无所谓，但执行两遍 :%s 就出事了。

解决办法是用 augroup 把命令分组，并在组内用 autocmd! 清除旧定义：

vim
augroup python_settings
  autocmd!
  autocmd FileType python setlocal shiftwidth=4 tabstop=4 expandtab
  autocmd FileType python setlocal colorcolumn=80
augroup END

autocmd! 放在组内第一行，意思是先清除 python_settings 组里之前注册的所有自动命令，再重新注册。这样不管 vimrc 被 source 多少次，每个 autocmd 都只会存在一份。

一个更完整的 vimrc 结构可能是这样的：

vim
augroup my_autocmds
  autocmd!
  " Python 用 4 空格
  autocmd FileType python setlocal shiftwidth=4 tabstop=4 expandtab
  " 前端用 2 空格
  autocmd FileType javascript,typescript,html,css setlocal shiftwidth=2 tabstop=2 expandtab
  " 保存时去掉行尾空格
  autocmd BufWritePre * :%s/\s\+$//e
  " 退出快速修复窗口按回车直接关闭
  autocmd FileType qf nnoremap <buffer> <CR> <CR>:cclose<CR>
augroup END

几个实用配置示例

保存配置文件后自动生效

vim
augroup vimrc_reload
  autocmd!
  autocmd BufWritePost init.vim source $MYVIMRC
  autocmd BufWritePost .vimrc source $MYVIMRC
augroup END

恢复上次编辑位置

Vim 默认不记住你上次光标停在哪，但 autocmd 可以做到：

vim
augroup restore_cursor
  autocmd!
  autocmd BufReadPost *
    \ if line("'"") >= 1 && line("'"") <= line("$") |
    \   exe "normal! g`"" |
    \ endif
augroup END

对特定目录的文件设为只读

vim
autocmd BufRead /var/log/* setlocal readonly

pattern 支持绝对路径匹配，这在管理服务器日志时很实用。

调试 autocmd

如果 autocmd 没按预期工作，几个排查手段：

:verbose autocmd BufWritePre * — 查看某个事件上注册了哪些命令，以及定义位置
:autocmd — 列出所有已注册的自动命令
设置 set verbose=9 后操作，Vim 会在执行 autocmd 时打印详细信息

另外注意 autocmd 默认不会嵌套触发：一个 autocmd 执行中引发的事件不会再触发其他 autocmd。如果确实需要嵌套，加 nested 关键字：

vim
autocmd FileChangedShell * nested edit

写在最后

autocmd 是 Vim 自动化的核心机制。掌握了事件、pattern 和 augroup 的组合方式，你就能让 Vim 在各种场景下自动做正确的事——不用记、不用想、不用每次手动设置。刚开始只需要记住 FileType + augroup + autocmd! 这个基本模式，剩下的在实际需求中慢慢积累就行。

标签：Vim