LSP-Zero.nvim 中配置诊断错误下划线为波浪线样式

在 Neovim 中使用 LSP 时，默认的错误提示下划线样式可能不符合部分用户的审美偏好。本文将详细介绍如何通过修改高亮组配置，将传统的直线下划线改为更具视觉区分度的波浪线样式。

技术背景

诊断信息（Diagnostics）是 LSP 核心功能之一，用于显示代码中的错误、警告等信息。Neovim 通过以下高亮组控制其显示样式：

• DiagnosticUnderlineError（错误）
• DiagnosticUnderlineWarn（警告）
• DiagnosticUnderlineInfo（信息）
• DiagnosticUnderlineHint（提示）

默认情况下，这些高亮组使用直线下划线（underline）。要改为波浪线（undercurl），需要同时满足：

1. 终端模拟器支持 undercurl 渲染
2. 正确配置高亮组属性

配置方法

在 Neovim 配置文件中（通常是 init.lua），添加以下代码：

-- 基础配置（需在colorscheme设置后执行）
vim.cmd.highlight('DiagnosticUnderlineError', 'gui=undercurl')
vim.cmd.highlight('DiagnosticUnderlineWarn', 'gui=undercurl')
vim.cmd.highlight('DiagnosticUnderlineInfo', 'gui=undercurl')
vim.cmd.highlight('DiagnosticUnderlineHint', 'gui=undercurl')

-- 进阶：带颜色配置（示例使用红色波浪线）
vim.cmd.highlight('DiagnosticUnderlineError', {
  guifg = 'Red',
  gui = 'undercurl',
  sp = 'Red'  -- 波浪线颜色
})

注意事项

1. 终端兼容性：不是所有终端都支持 undercurl 渲染，建议先在支持GUI模式的Neovim（如nvim-qt）中测试
2. 颜色方案优先级：配置应放在colorscheme设置之后，避免被覆盖
3. 多环境适配：可区分GUI和终端模式分别设置：

   if vim.fn.has('gui_running') == 1 then
     vim.cmd.highlight('DiagnosticUnderlineError', 'gui=undercurl')
   else
     vim.cmd.highlight('DiagnosticUnderlineError', 'cterm=underline')
   end
   

效果验证

1. 打开包含LSP错误的文件
2. 执行:checkhealth确认终端undercurl支持
3. 使用:hi DiagnosticUnderlineError查看当前高亮组配置

通过这种定制化配置，用户可以打造更符合个人偏见的LSP诊断显示效果，提升编码体验。