Conform.nvim 插件：实现保存时自动格式化开关控制方案

背景与需求分析

在Neovim生态中，Conform.nvim作为一款优秀的代码格式化插件，默认支持在文件保存时自动触发格式化操作。但在实际开发场景中，开发者可能遇到以下需求：

1. 临时编辑需要保持原格式的文件（如第三方代码）
2. 需要保留特定格式风格的协作项目
3. 调试时避免频繁格式化干扰

技术实现方案

核心机制

Conform.nvim通过自动命令(autocmd)实现保存时格式化功能。要控制该行为，本质上是管理BufWritePre事件的注册状态。

推荐实现方式

通过创建切换命令实现动态控制：

local format_is_enabled = true
vim.api.nvim_create_user_command('ConformToggleFormatOnSave', function()
  format_is_enabled = not format_is_enabled
  if format_is_enabled then
    vim.notify('Enabled format on save', vim.log.levels.INFO)
  else
    vim.notify('Disabled format on save', vim.log.levels.WARN)
  end
end, {})

local augroup = vim.api.nvim_create_augroup('format_on_save', { clear = true })
vim.api.nvim_create_autocmd('BufWritePre', {
  group = augroup,
  callback = function(args)
    if not format_is_enabled then return end
    require('conform').format({ bufnr = args.buf })
  end,
})

方案优势

1. 精确控制：只影响保存时格式化，不影响手动触发（如快捷键格式化）
2. 状态持久：通过变量保存当前状态
3. 视觉反馈：切换时显示通知消息
4. 非侵入式：不修改插件原有配置

高级用法扩展

对于需要更复杂控制的场景，可以扩展为：

local format_config = {
  enable = true,
  filetype_exceptions = {} -- 可按文件类型设置例外
}

vim.api.nvim_create_user_command('ConformToggleFormat', function(opts)
  if opts.args ~= '' then
    -- 支持按文件类型切换
    format_config.filetype_exceptions[opts.args] = not format_config.filetype_exceptions[opts.args]
  else
    format_config.enable = not format_config.enable
  end
end, { nargs = '?' })

注意事项

1. 该方案不影响其他保存时触发的自动命令（如lint检查）
2. 状态变量应放在合适的作用域以避免重复定义
3. 建议将配置放在Neovim的配置文件中（如init.lua）