今天最重要的心智模型：诊断是问题来源，quickfix / location list 是问题容器，trouble.nvim 是更漂亮的列表界面。

把这段放进 lua/lsp/init.lua，或者单独建 lua/config/diagnostics.lua 再在 init.lua 里 require。它只控制诊断如何显示，不负责启动 gopls。

vim.diagnostic.config({
  virtual_text = {
    prefix = ">",
    source = "if_many",
  },
  signs = true,
  underline = true,
  update_in_insert = false,
  severity_sort = true,
  float = {
    border = "rounded",
    source = "if_many",
  },
})

Day06 已经绑定过 [d / ]d。今天把它整理成一组可维护的诊断按键，并兼容不同 Neovim 版本。

local function diagnostic_jump(count)
  if vim.diagnostic.jump then
    vim.diagnostic.jump({ count = count })
    return
  end

  if count > 0 then
    vim.diagnostic.goto_next()
  else
    vim.diagnostic.goto_prev()
  end
end

vim.keymap.set("n", "gl", vim.diagnostic.open_float, { desc = "Line diagnostic" })
vim.keymap.set("n", "[d", function() diagnostic_jump(-1) end, { desc = "Previous diagnostic" })
vim.keymap.set("n", "]d", function() diagnostic_jump(1) end, { desc = "Next diagnostic" })
vim.keymap.set("n", "<leader>dq", function()
  vim.diagnostic.setqflist({ open = true })
end, { desc = "Diagnostics to quickfix" })
vim.keymap.set("n", "<leader>dl", function()
  vim.diagnostic.setloclist({ open = true })
end, { desc = "Diagnostics to location list" })

回到 Day05 的 tasknote 项目，故意写一个类型错误。先用诊断定位，再用 quickfix 收集。

package main

func BrokenTask() string {
  task := NewTask(123)
  return FormatTask(task)
}

quickfix 是 Vim 系编辑器的老能力，但它非常适合 Go 项目：一组错误、一组搜索结果、一组待处理位置，都可以放进去逐条处理。

vim.keymap.set("n", "<leader>qo", "<cmd>copen<cr>", { desc = "Open quickfix" })
vim.keymap.set("n", "<leader>qc", "<cmd>cclose<cr>", { desc = "Close quickfix" })
vim.keymap.set("n", "]q", "<cmd>cnext<cr>", { desc = "Next quickfix item" })
vim.keymap.set("n", "[q", "<cmd>cprev<cr>", { desc = "Previous quickfix item" })

Telescope 适合“找一个地方”，quickfix 适合“处理一批地方”。今天用 ripgrep 让 :grep 直接产生 quickfix 列表。

vim.opt.grepprg = "rg --vimgrep --smart-case"
vim.opt.grepformat = "%f:%l:%c:%m"

quickfix 最初就是为编译错误设计的。Go 的测试失败有不同形态，今天先处理编译错误和明显的文件行号错误。

vim.opt_local.makeprg = "go test ./..."
vim.opt_local.errorformat = "%A%f:%l:%c: %m,%A%f:%l: %m,%C%m"

trouble.nvim 不是必须项。它适合在问题很多时把 diagnostics、quickfix、location list 做成更好读的列表。先会原生 quickfix，再装它。

{
  "folke/trouble.nvim",
  opts = {},
  cmd = "Trouble",
  keys = {
    {
      "<leader>xx",
      "<cmd>Trouble diagnostics toggle<cr>",
      desc = "Diagnostics (Trouble)",
    },
    {
      "<leader>xX",
      "<cmd>Trouble diagnostics toggle filter.buf=0<cr>",
      desc = "Buffer diagnostics (Trouble)",
    },
    {
      "<leader>xq",
      "<cmd>Trouble qflist toggle<cr>",
      desc = "Quickfix list (Trouble)",
    },
    {
      "<leader>xl",
      "<cmd>Trouble loclist toggle<cr>",
      desc = "Location list (Trouble)",
    },
  },
}

今天的日志要记录你的“问题处理路线”。以后遇到报错，不是盯着屏幕焦虑，而是按路线走。

# Day10 diagnostics and quickfix log

## Diagnostics
- gopls attached:
- diagnostic float key:
- previous / next diagnostic key:

## Quickfix
- command used to fill quickfix:
- copen / cnext tested:
- one error fixed from quickfix:

## Search
- grepprg:
- grepformat:
- pattern searched:

## Optional Trouble
- installed:
- diagnostics command:
- qflist command:

## Decision
- when I use quickfix:
- when I use location list:
- when I use Trouble: