vim autocommands with vim plug don't load every time

近日，不少Vim用户在社区中反映一个典型问题：使用Vim-Plug插件管理器时，自定义的自动命令（autocommands）并非每次启动Vim都能正常加载。这一问题严重影响了工作效率，尤其是在需要依赖自动命令进行文件类型检测、语法高亮增强或快捷键绑定的场景下。经过多位资深用户排查，问题根源在于Vim-Plug的按需加载机制与自动命令的注册时机存在脱节。

问题重现：自动命令“间歇性消失”

用户通常会在vimrc或插件配置中编写如下代码：

autocmd FileType python nnoremap <buffer> <F5> :w<CR>:!python %<CR>
autocmd BufWritePre *.md :%s/\s\+$//e

理想情况下，每当打开Python文件或保存Markdown文件时，这些自动命令应被触发。然而，部分用户发现：首次启动Vim时自动命令工作正常；但关闭Vim重新打开后，自动命令失效，直到手动执行:source ~/.vimrc后才恢复。更诡异的是，有时仅部分自动命令失效，有时完全失效，行为不固定。

根源解析：Vim-Plug的“延迟加载”陷阱

问题核心在于Vim-Plug提供的on、for等按需加载选项。例如：

Plug 'some-plugin', { 'for': 'python' }

这表示该插件仅在打开Python文件时才被加载。类似地，on选项可指定命令触发加载。这种机制能显著减少启动时间，但同时也引入一个副作用：写在插件目录下的自动命令（如plugin/xxx.vim或after/plugin/xxx.vim中）只会在插件被加载时定义一次。如果用户将自定义自动命令直接放在插件目录中，并且该插件被标记为按需加载，那么自动命令的定义时机就与文件事件脱钩。

例如，用户在~/.vim/plugged/mysettings/plugin/autocmds.vim中放置：

augroup mygroup
    autocmd!
    autocmd FileType python setlocal tabstop=4
    autocmd BufWritePre *.json %!python -m json.tool
augroup END

当Vim启动时，如果从未打开Python或JSON文件，该插件不会加载，自动命令便永远不会注册。即使后续打开相关文件，插件虽然加载了，但自动命令的augroup已被autocmd!清空，而新的自动命令仅在此时注册一次，之后若关闭Vim重启，又恢复原状。

更隐蔽的情况是：用户将自动命令写在~/.vim/after/ftplugin/python.vim中，而某个插件通过Vim-Plug的for选项延迟加载，导致after/ftplugin目录的执行顺序被改变，从而自动命令被覆盖或跳过。

解决方案：三种策略确保每次生效

1. 将自动命令移入vimrc（推荐）

最直接的方法是放弃在插件目录中定义自动命令，统一在~/.vimrc中编写。由于vimrc始终在启动时完全加载，自动命令不会受按需加载影响。只需保证自动命令不依赖插件中的函数（若依赖，需用execute或has()判断插件是否加载），例如：

if has('python3')
    autocmd FileType python nnoremap <buffer> <F5> :w<CR>:!python3 %<CR>
endif

2. 使用Vim-Plug的`defer`选项

若必须将自动命令放在插件内，可以在插件定义时使用defer选项，强制Vim-Plug在启动时加载该插件，即使它被标记为按需加载：

Plug 'my-autocmd-plugin', { 'for': 'python', 'defer': 0 }

但defer参数并非Vim-Plug官方选项，实际需通过do或hook曲线实现。更稳妥的方法是明确不使用for/on，让插件始终加载。

3. 利用`VG`变量注册时机

在插件中使用augroup时，可考虑每次文件事件都重新定义自动命令，而非在插件加载时一次性定义。例如：

augroup mygroup
    autocmd! 
    autocmd BufRead * if &filetype == 'python' | setlocal tabstop=4 | endif
augroup END

但这样会频繁执行，效率低下。更合理的做法是放弃augroup!，或使用autocmd!仅在插件加载时清空一次。

最佳实践：区分“插件加载”与“自动命令触发”

Vim自动命令的生命周期取决于其定义的位置。建议遵循以下原则：

与具体文件类型或缓冲区相关的自动命令（如缩进、映射），应写在~/.vim/after/ftplugin/目录下，因为Vim会为每个缓冲区重新加载这些文件。
与全局事件相关的自动命令（如BufWritePre），应写在vimrc中。
若必须使用按需加载插件，确保自动命令定义放在plugin/目录中，且插件不使用for/on，或者使用autocmd!结合exists('*PluginFunction')判断。

结语

Vim-Plug的按需加载是双刃剑：既提升了启动速度，也带来了自动命令注册的困惑。通过理解Vim的启动顺序、插件加载时机以及自动命令的augroup机制，用户可以轻松避开这个“间歇性失灵”陷阱。对于追求稳定的用户，将所有自动命令统一写入vimrc，并配合条件判断，是成本最低且最可靠的方案。希望本文能帮助受此困扰的Vim用户彻底解决问题，重获高效编辑体验。

vim autocommands with vim plug don&#39;t load every time