[!info] related notes

• Mason [!info] 相关文章 mason

Mason 使用

目标

使用 Mason.nvim 在 Neovim 中管理 LSP 服务器、DAP 调试器、Linter 和 Formatter 的安装与更新。

前置条件

• Neovim 0.8+
• 已安装 mason.nvim 和 mason-lspconfig.nvim
• Git、npm/pip/cargo 等包管理器（按需）

步骤

1. 安装配置（lazy.nvim）

-- lua/plugins/mason.lua
return {
  "williamboman/mason.nvim",
  dependencies = {
    "williamboman/mason-lspconfig.nvim",
    "neovim/nvim-lspconfig",
  },
  config = function()
    require("mason").setup({
      ui = {
        icons = {
          package_installed = "✓",
          package_pending = "➜",
          package_uninstalled = "✗",
        },
      },
    })

    require("mason-lspconfig").setup({
      -- 自动安装以下 LSP 服务器
      ensure_installed = {
        "lua_ls",
        "ts_ls",
        "pyright",
        "rust_analyzer",
      },
      automatic_installation = true,
    })
  end,
}

2. 常用命令

命令	功能
:Mason	打开 Mason UI 界面，查看所有可用包
:MasonInstall <package>	安装指定包
:MasonUninstall <package>	卸载指定包
:MasonUpdate	更新所有已安装的包
:MasonLog	查看安装日志

3. 在 Mason UI 中操作

按 i  → 安装光标所在包
按 X  → 卸载光标所在包
按 U  → 更新光标所在包
按 g  → 查看包详情
按 ?  → 查看帮助

4. 手动安装特定版本

:MasonInstall lua-language-server@3.7.0

5. 配置安装路径（可选）

require("mason").setup({
  install_root_dir = vim.fn.stdpath("data") .. "/mason",
  PATH = "prepend",  -- "prepend" | "append" | "skip"
})

验证

1. 打开 :Mason 确认 UI 正常显示
2. 确认 ensure_installed 列表中的包状态为 ✓
3. 打开对应语言文件（如 .lua），确认 LSP 功能正常（跳转、补全、诊断）
4. 运行 :MasonLog 确认无安装错误