Conform.nvim 格式化插件配置问题解析

Conform.nvim 是一个强大的 Neovim 格式化插件，它能够帮助开发者自动格式化代码。然而，在配置过程中可能会遇到一些问题，特别是当插件无法识别已安装的格式化工具时。

问题现象

用户在 Windows 系统上使用 Neovim 0.9.5 版本时，发现 Conform.nvim 无法识别通过 Mason 安装的任何格式化工具。具体表现为：

• 在 Lua 文件中运行格式化命令时，插件提示找不到可用的格式化工具
• 调试日志显示"No formatters found"错误
• 虽然通过 Mason 确认了格式化工具已安装，但 ConformInfo 命令显示没有可用的格式化程序

问题根源

经过分析，问题的根本原因在于配置文件中缺少关键的formatters_by_ft字段。这是 Conform.nvim 的核心配置项，用于指定不同文件类型对应的格式化工具。

正确配置方法

正确的配置应该包含formatters_by_ft字段，示例如下：

require("conform").setup({
  formatters_by_ft = {
    lua = { "stylua" },
    typescript = { { "prettierd", "prettier" } },
    typescriptreact = { { "prettierd", "prettier" } },
    javascript = { { "prettierd", "prettier" } },
    javascriptreact = { { "prettierd", "prettier" } },
    json = { { "prettierd", "prettier" } },
    html = { { "prettierd", "prettier" } },
    css = { { "prettierd", "prettier" } },
  },
  format_on_save = {
    timeout_ms = 500,
    lsp_fallback = false,
  },
})

配置说明

1. formatters_by_ft是必须的配置项，它定义了文件类型与格式化工具的映射关系
2. 对于每种文件类型，可以指定单个格式化工具或多个候选工具
3. 使用子列表形式可以设置备用格式化工具，当首选工具不可用时自动尝试下一个
4. 其他配置如format_on_save等是可选的，用于控制格式化行为

最佳实践建议

1. 在配置前先通过 Mason 安装所需的格式化工具
2. 使用:ConformInfo命令验证配置是否正确加载
3. 对于不确定是否安装的工具，可以在命令行中直接运行其名称测试
4. 设置log_level = vim.log.levels.DEBUG有助于排查问题
5. 复杂的项目可以考虑使用.editorconfig文件来统一格式化规则

通过正确配置formatters_by_ft字段，Conform.nvim 就能正常识别和使用通过 Mason 安装的格式化工具，实现自动代码格式化的功能。