[!info] related notes

• AstroNvim使用指南
• Mason使用 [!info] 相关文章 astro-nvim-usage-guide

Mason

简单来说，您可以把 Mason 理解为 Neovim 的“应用商店”或“包管理器”。 在 VS Code 中，您安装插件（比如 Python 插件）时，它会自动帮您下载代码提示工具、调试器等。但在 Neovim 的世界里，Neovim 只是一个编辑器核心，它默认并不包含这些外部工具。 Mason 的作用就是帮您统一管理、下载、安装和升级这些外部工具。

---

Mason 具体管理哪四类工具？

Mason 能够一键安装以下四种核心开发工具，让 Neovim 具备 IDE 的能力：

1. LSP (Language Server Protocol): 语言服务器。

   • 作用: 提供代码自动补全、跳转定义、悬停文档、重命名等核心功能。
   • 例子: pyright (Python), typescript-language-server (JS/TS), gopls (Go)。

2. DAP (Debug Adapter Protocol): 调试适配器。

   • 作用: 让您能在 Neovim 里打断点、单步执行、查看变量。
   • 例子: debugpy (Python), codelldb (Rust/C++)。

3. Linter: 代码检查器。

   • 作用: 检查代码逻辑错误或潜在 bug（比 LSP 更细致）。
   • 例子: eslint (JS), pylint (Python)。

4. Formatter: 代码格式化器。

   • 作用: 自动把代码排版变得整齐漂亮。
   • 例子: prettier (前端通用), black (Python), stylua (Lua)。

---

为什么要用 Mason？（解决了什么痛点）

在没有 Mason 之前，配置 Neovim 非常痛苦，您需要手动去系统里安装各种环境：

• 想写 Python？得先去终端运行 pip install pyright。
• 想写 JS？得去运行 npm install -g typescript-language-server。
• 想写 Go？得去运行 go install ...。

使用 Mason 后：

Mason 创建了一个独立的沙盒环境。您不需要关心底层是用 pip、npm 还是 cargo 安装的。您只需要在 Neovim 里运行 :MasonInstall pyright，或者像我们刚才那样写在配置文件里，Mason 就会自动下载并管理好路径，完全不污染您的系统环境。

---

容易混淆的概念：Mason vs LSPConfig

这是一个新手最容易晕的地方，请注意区分：

1. Mason: 只是下载员。

   • 它只负责把 pyright 这个可执行文件下载到您的电脑上。
   • 它不知道怎么把这个文件连接到 Neovim 上。

2. LSPConfig (nvim-lspconfig): 是连接员。

   • 它负责告诉 Neovim：“嘿，我发现电脑里有个 pyright，我要启动它来分析 Python 代码。”

在 AstroNvim 中：

这就解释了为什么会有 mason.lua 这个文件。AstroNvim 帮您把“下载员”和“连接员”自动配对好了。您只需要在 mason.lua 的 ensure_installed 列表里填上名字，AstroNvim 就会：

1. 调用 Mason 去下载。
2. 自动配置好 LSP 启动。

总结

• Mason = Neovim 的全能工具箱安装器。
• 您刚才修改的 mason.lua = 给这个工具箱列了一张“必买清单”，以后无论换哪台电脑，只要把配置一拷，Neovim 启动时就会自动把这些工具全部装好。