如何消除Neovim中lua_ls提示的Undefined global `vim`警告？

问题分析 #

你已在lua_ls配置中声明diagnostics.globals = {"vim"}，但仍出现"Undefined global vim"诊断警告，通常是因为lua_ls未正确加载配置，或配置存在细节疏漏。

解决步骤 #

1. 补全lazy.nvim依赖 #

你的配置用到了cmp-nvim-lsp的default_capabilities()方法，需将其添加为依赖，避免加载异常：

return {
        "mason-org/mason-lspconfig.nvim",
        opts = {},
        dependencies = {
                { "mason-org/mason.nvim", opts = {} },
                "neovim/nvim-lspconfig",
                "hrsh7th/cmp-nvim-lsp", -- 添加该依赖
        },
}

2. 修正lua_ls配置 #

将lua_ls配置整合到mason-lspconfig的opts中（替代after文件夹的配置，规避加载顺序问题），确保配置被正确读取：

return {
        "mason-org/mason-lspconfig.nvim",
        opts = {
                ensure_installed = {
                        "lua_ls",
                        "ts_ls",
                        "rust_analyzer",
                },
                handlers = {
                        function(server_name)
                                local capabilities = require('cmp_nvim_lsp').default_capabilities()
                                require('lspconfig')[server_name].setup {
                                        capabilities = capabilities,
                                }
                        end,

                        ["lua_ls"] = function()
                                local lspconfig = require("lspconfig")
                                local capabilities = require('cmp_nvim_lsp').default_capabilities()
                                lspconfig.lua_ls.setup {
                                        capabilities = capabilities,
                                        settings = {
                                                Lua = {
                                                        runtime = {
                                                                version = 'LuaJIT'
                                                        },
                                                        diagnostics = {
                                                                -- 明确声明vim为全局变量
                                                                globals = { "vim" },
                                                        },
                                                        workspace = {
                                                                -- 加载Neovim runtime文件，提供vim API类型支持
                                                                library = vim.api.nvim_get_runtime_file("", true),
                                                                checkThirdParty = false, -- 关闭第三方库检查，避免干扰
                                                        },
                                                        telemetry = { enable = false },
                                                },
                                        },
                                }
                        end,
                }
        },
        dependencies = {
                { "mason-org/mason.nvim", opts = {} },
                "neovim/nvim-lspconfig",
                "hrsh7th/cmp-nvim-lsp",
        },
}

3. 确认lua_ls已安装 #

运行:Mason命令，检查lua_ls是否在已安装列表中，未安装则选中按i安装，之后重启Neovim。

4. 单文件临时规避（可选） #

若个别文件仍有警告，可在vim调用前添加注释临时禁用诊断：

---@diagnostic disable-next-line: undefined-global
vim.diagnostic.config({
        virtual_text = true,
        signs = false,
        underline = false,
        update_in_insert = false,
        severity_sort = true,
})

验证 #

重启Neovim后打开配置文件，检查警告是否消失。若仍存在，运行:LspInfo查看lua_ls配置是否正确加载，确认settings.Lua.diagnostics.globals包含vim。

内容的提问来源于stack exchange，提问作者Taz