Coc.nvim 中如何按诊断级别过滤 CocList 诊断信息

在 Coc.nvim 插件中，诊断信息的显示级别控制是一个常见的需求场景。开发者可能希望在浮动窗口中显示所有级别的诊断信息（包括 Hint 级别），但在诊断列表中只显示更重要的信息（如 Error、Warning 和 Information 级别）。

诊断级别控制机制

Coc.nvim 提供了多层次的诊断信息过滤机制：

1. 全局诊断级别控制：通过 diagnostic.level 配置项可以设置全局诊断级别，但这会影响所有诊断信息的显示，包括浮动窗口和列表。

2. 位置列表级别控制：通过 locationlistLevel 可以单独控制位置列表中的诊断级别。

3. CocList 诊断过滤：这是本文要重点介绍的功能，它允许单独控制诊断列表中的显示级别。

配置 CocList 诊断过滤

要实现只过滤 CocList 诊断列表而不影响浮动窗口显示，可以使用以下配置：

"list.source.diagnostics.defaultArgs": ["-level", "information"]

这个配置会将 CocList 诊断列表限制为 Information 级别及以上的诊断信息（即 Error、Warning 和 Information），而 Hint 级别的诊断将不会出现在列表中。

实际应用场景

这种分级显示机制特别适合以下场景：

• 开发者在编码时需要看到所有提示（包括 Hint），但在集中处理问题时只想关注更重要的诊断信息
• 项目中有大量代码风格提示（Hint 级别），但不想让它们淹没重要的错误警告
• 需要区分查看不同严重程度的问题时

高级配置选项

除了基本的级别过滤外，CocList 诊断还支持更多过滤参数：

• 按文件路径过滤
• 按诊断来源过滤
• 组合多个过滤条件

这些功能可以通过 :CocList diagnostics 命令后跟参数实现，或在配置中设置默认参数。

总结

Coc.nvim 提供了灵活的诊断信息分级显示机制，通过合理配置可以兼顾编码时的全面提示和问题排查时的专注需求。理解这些过滤机制的组合使用，可以帮助开发者更高效地利用诊断信息进行开发工作。