Neovim配置保存自动格式化（非LSP插件）问题排查

问题描述 #

尝试在Neovim中配置保存时自动格式化代码，不使用LSP插件。当前针对Python文件调用black的配置代码如下：

vim.api.nvim_create_augroup("AutoFormat", {})

vim.api.nvim_create_autocmd(
    "BufWritePre",
    {
        pattern = "*.py",
        group = "AutoFormat",
        callback = function()
            vim.cmd("!black --quiet %")            
            -- vim.cmd("write!")
        end,
    }
)

回调函数能正常运行，但代码未被格式化，Neovim输出：

:!black --quiet test.py
"test.py" 5L, 86B written
Press ENTER or type command to continue

手动执行!black --quiet %可正常格式化缓冲区代码，但自动触发时无效，希望执行:w时完成格式化并保存。后续计划扩展支持Go、Rust、SQL等语言。

解决方案 #

原代码的问题在于：BufWritePre触发时，Neovim还未完成保存，执行!black会修改磁盘上的文件，但Neovim缓冲区的内容并未同步更新，之后默认的保存操作会把缓冲区旧内容覆盖格式化后的文件。

修改后的配置如下：

vim.api.nvim_create_augroup("AutoFormat", {})

vim.api.nvim_create_autocmd(
    "BufWritePre",
    {
        pattern = "*.py",
        group = "AutoFormat",
        callback = function()
            -- 静默执行black格式化，避免弹出回车提示
            vim.cmd("silent !black --quiet %")
            -- 强制重新加载文件，同步缓冲区与磁盘内容
            vim.cmd("edit!")
        end,
    }
)

关键说明 #

• silent：让外部命令在后台执行，不会弹出需要按回车确认的提示，自动完成格式化流程。
• edit!：强制重新读取磁盘上的文件内容，将缓冲区更新为格式化后的版本，确保后续保存的是正确内容。

多语言扩展建议 #

针对不同语言，只需新增对应pattern和格式化命令的autocmd即可，示例如下：

-- Go 格式化（使用gofmt）
vim.api.nvim_create_autocmd(
    "BufWritePre",
    {
        pattern = "*.go",
        group = "AutoFormat",
        callback = function()
            vim.cmd("silent !gofmt -w %")
            vim.cmd("edit!")
        end,
    }
)

-- Rust 格式化（使用rustfmt）
vim.api.nvim_create_autocmd(
    "BufWritePre",
    {
        pattern = "*.rs",
        group = "AutoFormat",
        callback = function()
            vim.cmd("silent !rustfmt %")
            vim.cmd("edit!")
        end,
    }
)

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