Skip to content

feat: add support for new LSP config API in Neovim 0.11+ #1475

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 13 commits into
base: master
Choose a base branch
from
+13 −20
Open

feat: add support for new LSP config API in Neovim 0.11+ #1475

Changes from 11 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
3f0cd75
feat: add support for new LSP config API in Neovim 0.11+
umutondersu Apr 16, 2025
f70dcb3
Typo fix
umutondersu Apr 16, 2025
4b81900
fix(lsp): correct variable name in lsp config loop
umutondersu Apr 17, 2025
5502cea
style: format with stylua
umutondersu Apr 17, 2025
a590ab6
fix(lsp): Remove backwards compatibility and add comments for lsp setup
umutondersu Apr 20, 2025
dac395d
fix: Typo in comment
umutondersu Apr 20, 2025
531073d
fix: revert back to original handler logic
umutondersu Apr 21, 2025
81c5210
Fix: correct variables inside comments
umutondersu Apr 30, 2025
9e0c7b6
fix(deps): pin mason plugin versions to v1.*
umutondersu May 10, 2025
0018683
feat(lsp): Update Mason to v2
umutondersu May 11, 2025
f9628e5
Merge branch 'master' into master
umutondersu May 11, 2025
718c90d
fix: mason server name
umutondersu May 11, 2025
82949b8
Refactor(lsp): Ensure automatic server enabling
umutondersu May 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 10 additions & 22 deletions init.lua
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -482,8 +482,8 @@ require('lazy').setup({
-- Automatically install LSPs and related tools to stdpath for Neovim
-- Mason must be loaded before its dependents so we need to set it up here.
-- NOTE: `opts = {}` is the same as calling `require('mason').setup({})`
{ 'mason-org/mason.nvim', opts = {} },
'mason-org/mason-lspconfig.nvim',
{ 'mason-orgmason.nvim', opts = {} },
{ 'mason-org/mason-lspconfig.nvim', opts = {} },
'WhoIsSethDaniel/mason-tool-installer.nvim',

-- Useful status updates for LSP.
Expand Down Expand Up @@ -655,12 +655,6 @@ require('lazy').setup({
},
}

-- LSP servers and clients are able to communicate to each other what features they support.
-- By default, Neovim doesn't support everything that is in the LSP specification.
-- When you add blink.cmp, luasnip, etc. Neovim now has *more* capabilities.
-- So, we create new capabilities with blink.cmp, and then broadcast that to the servers.
local capabilities = require('blink.cmp').get_lsp_capabilities()

-- Enable the following language servers
-- Feel free to add/remove any LSPs that you want here. They will automatically be installed.
--
Expand Down Expand Up @@ -719,20 +713,14 @@ require('lazy').setup({
})
require('mason-tool-installer').setup { ensure_installed = ensure_installed }

require('mason-lspconfig').setup {
ensure_installed = {}, -- explicitly set to an empty table (Kickstart populates installs via mason-tool-installer)
automatic_installation = false,
handlers = {
function(server_name)
local server = servers[server_name] or {}
-- This handles overriding only values explicitly passed
-- by the server configuration above. Useful when disabling
-- certain features of an LSP (for example, turning off formatting for ts_ls)
server.capabilities = vim.tbl_deep_extend('force', {}, capabilities, server.capabilities or {})
require('lspconfig')[server_name].setup(server)
end,
},
}
-- Installed LSPs are configured and enabled automatically with mason-lspconfig
-- The loop below is for overriding the default configuration of LSPs with the ones in the servers table
for server_name, config in pairs(servers) do
vim.lsp.config(server_name, config)
Copy link

@justinmk justinmk Sep 17, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is the right approach 👍 . Using vim.lsp.config is the only supported approach for Nvim 0.11+.

Nvim 0.11+ should not use require('lspconfig').

nvim-lspconfig will soon be deleting all of its lua/lspconfig/* configs (which have been deprecated for 6+ months) in favor of lsp/*.

Copy link

@logrusx logrusx Sep 19, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That alone won't do anything. You can't just swap [servername].setup with vim.lsp.config. You should now provide the config in its entirety.
Also you need to enable the server somewhere.

end

-- NOTE: Some servers may require an old setup until they are updated. For the full list refer here: https://github.com/neovim/nvim-lspconfig/issues/3705
-- These servers will have to be manually set up with require("lspconfig").server_name.setup{}
end,
},

Expand Down