Go 格式化有层次。先知道每个工具负责什么，再决定保存时调用谁。

LSP 路线的优点是统一：格式化、诊断、代码动作都由 gopls 提供。先把按键放进 Day06 的 on_attach。

map("<leader>lf", function()
  vim.lsp.buf.format({ async = false })
end, "Format current buffer")

再加保存时自动格式化。把它放进 lua/lsp/init.lua 的 on_attach 内部，确保只在 LSP attach 后启用。

local group = vim.api.nvim_create_augroup("GoLspFormat", { clear = false })

vim.api.nvim_clear_autocmds({ group = group, buffer = bufnr })
vim.api.nvim_create_autocmd("BufWritePre", {
  group = group,
  buffer = bufnr,
  callback = function()
    vim.lsp.buf.format({ async = false, bufnr = bufnr })
  end,
})

外部路线的优点是可解释：你明确知道保存时调用了哪个二进制。今天推荐先用 goimports，因为它会整理 import。

local function goimports()
  local file = vim.api.nvim_buf_get_name(0)
  if file == "" then
    return
  end

  vim.cmd.write()
  vim.system({ "goimports", "-w", file }, { text = true }, function(result)
    vim.schedule(function()
      if result.code ~= 0 then
        vim.notify(result.stderr, vim.log.levels.ERROR)
        return
      end
      vim.cmd.edit()
    end)
  end)
end

vim.keymap.set("n", "<leader>gf", goimports, { desc = "Format Go file with goimports" })

如果你已经在 Day06 接好了 gopls，推荐优先用 LSP：保存前先执行 organize imports，再 format。这样逻辑都留在 gopls 这条链路里。

local function organize_imports(bufnr)
  local params = vim.lsp.util.make_range_params(nil, "utf-16")
  params.context = { only = { "source.organizeImports" } }

  local clients = vim.lsp.get_clients({ bufnr = bufnr, name = "gopls" })
  for _, client in ipairs(clients) do
    local result = client.request_sync("textDocument/codeAction", params, 1000, bufnr)
    for _, action in ipairs(result and result.result or {}) do
      if action.edit then
        vim.lsp.util.apply_workspace_edit(action.edit, client.offset_encoding)
      end
    end
  end
end

local function format_go(bufnr)
  organize_imports(bufnr)
  vim.lsp.buf.format({
    bufnr = bufnr,
    async = false,
    filter = function(client)
      return client.name == "gopls"
    end,
  })
end

然后在 on_attach 中绑定保存前动作：

local group = vim.api.nvim_create_augroup("GoLspFormat", { clear = false })

vim.api.nvim_clear_autocmds({ group = group, buffer = bufnr })
vim.api.nvim_create_autocmd("BufWritePre", {
  group = group,
  buffer = bufnr,
  callback = function()
    format_go(bufnr)
  end,
})

回到 tasknote，故意写乱 import、缩进和未使用包。保存时观察它们是否被整理。

package main

import (
  "fmt"
  "strings"
  "os"
)

func DebugTask(title string) string {
task, err := NewTask(strings.TrimSpace(title))
if err != nil {
return fmt.Sprintf("error: %v", err)
}
return FormatTask(task)
}

不要只说“保存会格式化”。要能说出是哪条链路触发了格式化。

今天的日志重点记录你选择了哪条格式化路线。以后团队项目里最容易争论的就是格式化来源。

# Day09 formatting and imports log

## Tools
- gofmt:
- goimports:
- gofumpt:

## Format source
- LSP or external:
- BufWritePre group:
- command used to inspect:

## Import cleanup
- broken file:
- before save:
- after save:

## Decision
- my default formatter:
- when I would use gofumpt: