在Nvimdots中配置非Mason管理的GLSL语言服务器

背景介绍

Nvimdots是一个优秀的Neovim配置框架，它默认使用Mason作为语言服务器管理器。然而，并非所有语言服务器都能通过Mason安装，比如GLSL语言服务器glsl-analyzer。本文将详细介绍如何在Nvimdots中正确配置这类非Mason管理的语言服务器。

准备工作

在开始配置前，需要确保已经完成以下准备工作：

1. 已手动安装glsl-analyzer并确保其在系统PATH中可用
2. 已安装tree-sitter的GLSL语法支持
3. 了解Nvimdots的基本配置结构

配置步骤

1. 创建LSP配置文件

在lua/user/configs/lsp.lua中创建基础配置，这里我们添加对glsl-analyzer的支持：

local nvim_lsp = require("lspconfig")
local opts = {
    capabilities = require("cmp_nvim_lsp").default_capabilities(vim.lsp.protocol.make_client_capabilities()),
}

-- 配置非Mason管理的语言服务器
if vim.fn.executable("glsl_analyzer") == 1 then
    local ok, _opts = pcall(require, "user.configs.lsp-servers.glsl_analyzer")
    if ok then
        local final_opts = vim.tbl_deep_extend("keep", _opts, opts)
        nvim_lsp.glsl_analyzer.setup(final_opts)
    end
end

2. 创建语言服务器专用配置

在lua/user/configs/lsp-servers/glsl_analyzer.lua中定义glsl-analyzer的详细配置：

return {
    default_config = {
        cmd = { "glsl_analyzer" },
        filetypes = { "glsl", "vert", "tesc", "tese", "frag", "geom", "comp" },
        single_file_support = true,
    },
    docs = {
        description = [[
语言服务器，支持GLSL着色器语言
        ]],
    },
}

3. 配置文件类型识别

由于GLSL有多种文件扩展名，我们需要确保Neovim能正确识别这些文件类型。创建lua/user/plugins/lang.lua：

local lang = {}

lang["tikhomirov/vim-glsl"] = {
    lazy = true,
    ft = { "glsl", "vert", "tesc", "tese", "frag", "geom", "comp" },
}

return lang

技术要点解析

1. 文件类型检测：GLSL着色器有多种文件扩展名(.vert, .frag等)，vim-glsl插件负责正确设置文件类型。

2. LSP配置合并：使用vim.tbl_deep_extend将默认配置与自定义配置合并，确保不丢失基础功能。

3. 可执行性检查：通过vim.fn.executable检查glsl-analyzer是否可用，避免配置无效服务器。

4. 懒加载：通过lazy=true配置，插件只在打开相关文件时加载，提高启动速度。

验证配置

完成上述配置后，打开一个.vert或.frag文件，执行:LspInfo命令应该能看到glsl-analyzer已正确加载并提供服务。

常见问题解决

1. 服务器未启动：检查glsl-analyzer是否在PATH中，可通过终端直接执行命令测试。

2. 文件类型未识别：确保vim-glsl插件已正确安装并配置了所有GLSL文件扩展名。

3. 功能不完整：检查capabilities配置是否正确合并，确保补全等功能可用。

通过以上步骤，我们成功在Nvimdots中集成了非Mason管理的GLSL语言服务器，为着色器开发提供了完整的IDE支持。