223 lines
9.3 KiB
Lua
223 lines
9.3 KiB
Lua
-- =============================================================================
|
||
-- LSP、格式化与诊断配置 (lua/plugins/lsp.lua)
|
||
-- =============================================================================
|
||
-- 本文件配置 Neovim 的 LSP 客户端、代码格式化（conform.nvim）和诊断导航。
|
||
--
|
||
-- 加载方式：
|
||
-- 由 pack.lua 通过 lazy.on_event("lsp", "VimEnter", "*", ...) 延迟加载，
|
||
-- 在 VimEnter 事件触发后初始化，避免阻塞 startup。
|
||
--
|
||
-- 依赖加载顺序：
|
||
-- 1. conform.nvim（BufWritePre 时按需 packadd 加载）
|
||
-- 2. nvim-lspconfig（直接 packadd）
|
||
-- 3. mason.nvim（直接 setup）
|
||
-- =============================================================================
|
||
local lazy = require("lazy")
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- conform.nvim — 代码格式化（BufWritePre 懒加载）
|
||
-- ---------------------------------------------------------------------------
|
||
-- conform.nvim 是一个轻量级格式化器包装器，支持保存时自动格式化。
|
||
-- 由于格式化器通常不是立即需要的，通过 lazy.on_event 在 BufWritePre 时
|
||
-- 才进行 packadd 和 setup。
|
||
local function setup_conform()
|
||
-- 通过 packadd 加载 conform.nvim（因为 vim.pack.add 时设置了 load = false）
|
||
vim.cmd.packadd("conform.nvim")
|
||
|
||
-- 动态判断使用 Biome 还是 Prettier。
|
||
-- 从当前文件向上搜索 biome.json / biome.jsonc，如果找到则使用 Biome，
|
||
-- 否则回退到 Prettier。stop 参数限制搜索到用户主目录，避免向上搜索到根目录。
|
||
local function biome_or_prettier()
|
||
if vim.fs.find({ "biome.json", "biome.jsonc" }, { upward = true, stop = vim.uv.os_homedir() })[1] then
|
||
return { "biome-check", "biome", stop_after_first = true }
|
||
end
|
||
return { "prettier" }
|
||
end
|
||
|
||
require("conform").setup({
|
||
-- 按文件类型配置格式化器
|
||
formatters_by_ft = {
|
||
lua = { "stylua" }, -- Lua 格式化
|
||
go = { "gofumpt", "goimports" }, -- Go：先 gofumpt 格式化，再 goimports 整理导入
|
||
javascript = biome_or_prettier, -- JS：Biome 或 Prettier
|
||
typescript = biome_or_prettier, -- TS：Biome 或 Prettier
|
||
javascriptreact = biome_or_prettier, -- JSX：Biome 或 Prettier
|
||
typescriptreact = biome_or_prettier, -- TSX：Biome 或 Prettier
|
||
json = biome_or_prettier, -- JSON：Biome 或 Prettier
|
||
css = { "prettier" }, -- CSS：Prettier
|
||
html = { "prettier" }, -- HTML：Prettier
|
||
markdown = { "prettier" }, -- Markdown：Prettier
|
||
toml = { "taplo" }, -- TOML：taplo
|
||
},
|
||
|
||
-- 保存时自动格式化回调
|
||
-- 可通过 vim.b[bufnr].autoformat = false 关闭当前 buffer 的自动格式化
|
||
-- 或通过 vim.g.autoformat = false 全局关闭
|
||
format_on_save = function(bufnr)
|
||
if vim.b[bufnr].autoformat == false or vim.g.autoformat == false then
|
||
return nil -- 返回 nil 表示不格式化
|
||
end
|
||
return { timeout_ms = 500, lsp_fallback = true }
|
||
end,
|
||
})
|
||
end
|
||
|
||
-- BufWritePre 时触发 conform 加载。
|
||
-- 注意：conform 的 setup 内部会注册自己的 BufWritePre autocmd，
|
||
-- 但新创建的 autocmd 不会在同一次事件中触发。
|
||
-- 因此这里手动调用 format 补偿第一次保存（确保首次保存也能格式化）。
|
||
lazy.on_event("conform", "BufWritePre", "*", function()
|
||
setup_conform()
|
||
local bufnr = vim.api.nvim_get_current_buf()
|
||
if vim.b[bufnr].autoformat ~= false and vim.g.autoformat ~= false then
|
||
require("conform").format({ bufnr = bufnr, timeout_ms = 500, lsp_fallback = true })
|
||
end
|
||
end)
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- Mason + LSP 配置
|
||
-- ---------------------------------------------------------------------------
|
||
-- Mason 是 LSP 服务器、DAP 适配器和格式化工具的安装管理器。
|
||
-- nvim-lspconfig 提供常见 LSP 服务器的预设配置。
|
||
vim.cmd.packadd("nvim-lspconfig")
|
||
lazy.track("lspconfig")
|
||
|
||
require("mason").setup()
|
||
lazy.track("mason")
|
||
|
||
-- 构建 LSP 客户端 capabilities（能力声明），告知服务器客户端支持的功能。
|
||
-- 先获取 Neovim 默认 capabilities，再与 mini.completion 的 LSP 补全能力合并。
|
||
local capabilities = vim.lsp.protocol.make_client_capabilities()
|
||
capabilities = vim.tbl_deep_extend("force", capabilities, require("mini.completion").get_lsp_capabilities())
|
||
|
||
-- 为所有 LSP 服务器设置默认 capabilities
|
||
vim.lsp.config("*", { capabilities = capabilities })
|
||
|
||
-- Lua 语言服务器特殊配置：将 "vim" 声明为全局变量，避免 "Undefined global" 诊断
|
||
vim.lsp.config("lua_ls", {
|
||
settings = {
|
||
Lua = {
|
||
diagnostics = { globals = { "vim" } },
|
||
},
|
||
},
|
||
})
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- 已安装的 Mason 工具清单（通过 :Mason 查看）
|
||
-- ---------------------------------------------------------------------------
|
||
-- 以下是通过 Mason 安装的 LSP 服务器和工具：
|
||
-- ◍ biome - JS/TS/JSON 格式化和 lint
|
||
-- ◍ css-lsp - CSS 语言服务器
|
||
-- ◍ gofumpt - Go 格式化（stricter than gofmt）
|
||
-- ◍ goimports - Go 导入整理
|
||
-- ◍ golangci-lint - Go linter
|
||
-- ◍ gopls - Go 语言服务器
|
||
-- ◍ html-lsp - HTML 语言服务器
|
||
-- ◍ kotlin-lsp - Kotlin 语言服务器
|
||
-- ◍ lua-language-server- Lua 语言服务器
|
||
-- ◍ prettier - 通用代码格式化器
|
||
-- ◍ rust-analyzer - Rust 语言服务器
|
||
-- ◍ stylua - Lua 格式化器
|
||
-- ◍ svelte-language-server - Svelte 语言服务器
|
||
-- ◍ taplo - TOML 工具
|
||
-- ◍ vtsls - TypeScript 语言服务器（VS Code 的 TS 服务端移植）
|
||
|
||
-- 启用指定的 LSP 服务器
|
||
vim.lsp.enable({
|
||
"html", -- HTML 语言支持
|
||
"cssls", -- CSS/SCSS/Less 语言支持
|
||
"gopls", -- Go 语言支持
|
||
"vtsls", -- TypeScript/JavaScript 支持（推荐替代 tsserver）
|
||
"rust_analyzer", -- Rust 语言支持
|
||
"lua_ls", -- Lua 语言支持
|
||
"taplo", -- TOML 支持
|
||
"svelte", -- Svelte 框架支持
|
||
"kotlin_lsp", -- Kotlin 支持
|
||
})
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- LSP 键位映射
|
||
-- ---------------------------------------------------------------------------
|
||
-- 使用函数包装器包裹 LSP 调用，延迟加载 vim.lsp / vim.diagnostic 模块，
|
||
-- 避免在启动时预加载这些重型模块。
|
||
|
||
-- gd - Go to Definition：跳转到定义位置
|
||
vim.keymap.set("n", "gd", function()
|
||
vim.lsp.buf.definition()
|
||
end, { desc = "跳转到定义" })
|
||
|
||
-- gh - Hover：显示光标下符号的文档悬浮窗
|
||
vim.keymap.set("n", "gh", function()
|
||
vim.lsp.buf.hover()
|
||
end, { desc = "悬停查看文档" })
|
||
|
||
-- <leader>fm - 手动格式化当前 buffer
|
||
vim.keymap.set("n", "<leader>fm", function()
|
||
lazy.load("conform", setup_conform)
|
||
require("conform").format({ lsp_fallback = true })
|
||
end, { desc = "格式化当前 Buffer" })
|
||
|
||
-- df - 显示当前行的诊断浮动窗口
|
||
vim.keymap.set("n", "df", function()
|
||
vim.diagnostic.open_float()
|
||
end, { desc = "显示行诊断" })
|
||
|
||
-- <leader>ca - Code Action：显示可用的代码操作（如自动修复、重构）
|
||
vim.keymap.set("n", "<leader>ca", function()
|
||
vim.lsp.buf.code_action()
|
||
end, { desc = "代码操作" })
|
||
|
||
-- <leader>cr - Rename：重命名光标下的符号
|
||
vim.keymap.set("n", "<leader>cr", function()
|
||
vim.lsp.buf.rename()
|
||
end, { desc = "重命名符号" })
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- 诊断导航
|
||
-- ---------------------------------------------------------------------------
|
||
-- 辅助函数：创建诊断跳转的闭包。
|
||
-- 参数：
|
||
-- next - true 表示向后跳，false 表示向前跳
|
||
-- severity - 可选的严重性过滤（"ERROR", "WARN", "INFO", "HINT"）
|
||
--
|
||
-- vim.v.count1 是计数前缀的默认值（无数字时为 1），
|
||
-- 支持 3]d 跳转到第 3 个诊断。
|
||
local diagnostic_goto = function(next, severity)
|
||
return function()
|
||
vim.diagnostic.jump({
|
||
count = (next and 1 or -1) * vim.v.count1,
|
||
severity = severity and vim.diagnostic.severity[severity] or nil,
|
||
float = true, -- 跳转时显示诊断浮动窗口
|
||
})
|
||
end
|
||
end
|
||
|
||
-- ]d / [d - 下一个 / 上一个诊断（所有级别）
|
||
vim.keymap.set("n", "]d", diagnostic_goto(true), { desc = "下一个诊断" })
|
||
vim.keymap.set("n", "[d", diagnostic_goto(false), { desc = "上一个诊断" })
|
||
|
||
-- ]e / [e - 下一个 / 上一个错误
|
||
vim.keymap.set("n", "]e", diagnostic_goto(true, "ERROR"), { desc = "下一个错误" })
|
||
vim.keymap.set("n", "[e", diagnostic_goto(false, "ERROR"), { desc = "上一个错误" })
|
||
|
||
-- ]w / [w - 下一个 / 上一个警告
|
||
vim.keymap.set("n", "]w", diagnostic_goto(true, "WARN"), { desc = "下一个警告" })
|
||
vim.keymap.set("n", "[w", diagnostic_goto(false, "WARN"), { desc = "上一个警告" })
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- 诊断显示配置
|
||
-- ---------------------------------------------------------------------------
|
||
-- - virtual_text: 代码行右侧显示诊断文本
|
||
-- - signs: 左侧 sign column 的诊断标志（0.12 默认为 E/W/I/H 字母）
|
||
vim.diagnostic.config({
|
||
virtual_text = true,
|
||
signs = {
|
||
text = {
|
||
[vim.diagnostic.severity.ERROR] = "✖",
|
||
[vim.diagnostic.severity.WARN] = "▲",
|
||
[vim.diagnostic.severity.INFO] = "i",
|
||
[vim.diagnostic.severity.HINT] = "h",
|
||
},
|
||
},
|
||
})
|