mason.nvim
v1.10.0
Tragbarer Paketmanager für Neovim, der überall ausführt, wo Neovim ausgeführt wird.
LSP -Server, DAP -Server, Linter und Formatter einfach installieren und verwalten.
:help mason.nvim
Neueste Version: v1.10.0
:h mason-introduction
mason.nvim ist ein Neovim -Plugin, mit dem Sie externe Editor -Tools wie LSP -Server, DAP -Server, Linter und Formatter über eine einzelne Schnittstelle problemlos verwalten können. Es wird überall ausgeführt, wo Neovim (über Linux, MacOS, Windows usw.) ausgeführt wird, wobei nur ein kleiner Satz externer Anforderungen erforderlich ist.
Pakete werden standardmäßig im Datenverzeichnis von Neovim ( :h standard-path ) installiert. Executables sind mit einem einzelnen bin/ Verzeichnis verknüpft, das mason.nvim während des Setups zu Neovims Pfad hinzufügt, sodass NEOVIM -BAU -BAUS (SHELL, Terminal usw.) sowie andere Plugins von Drittanbietern den Zugriff von Neovim -Inbauungen ermöglichen.
Eine Liste aller verfügbaren Pakete finden Sie unter https://mason-registry.dev/registry/List.
:h mason-how-to-use-packages
Obwohl viele Pakete durch Neovim -Bausträger vollkommen verwendbar sind, wird empfohlen, andere Plugins von Drittanbietern zu verwenden, um diese weiter zu integrieren. Die folgenden Plugins werden empfohlen:
lspconfig & mason-lspconfig.nvimnvim-dap & nvim-dap-uinull-ls.nvim oder nvim-lintnull-ls.nvim oder formatter.nvim  |  |  |
 |  |  |
:h mason-requirements
mason.nvim lockert die Mindestanforderungen, indem sie mehrere verschiedene Versorgungsunternehmen versuchen (z. B. wget , curl und Invoke-WebRequest sind perfekte Ersatzstoffe). Die empfohlenen Mindestanforderungen sind:
>= 0.7.0git(1)curl(1) oder wget(1)unzip(1)tar(1) oder gtar(1) Abhängig von der Plattform)gzip(1) Beachten Sie, dass mason.nvim regelmäßig an externe Paketmanager wie cargo und npm ausgeschaltet wird. Abhängig von Ihrem persönlichen Gebrauch müssen auch einige davon installiert werden. Weitere Informationen finden Sie unter :checkhealth mason für eine vollständige Liste.
use {
" williamboman/mason.nvim "
}{
" williamboman/mason.nvim "
}Plug ' williamboman/mason.nvim '
:h mason-quickstart
require ( " mason " ). setup () mason.nvim ist optimiert, um während des Einrichtung so wenig wie möglich zu laden. Es wird nicht empfohlen, das Plugin faul zu laden oder das Setup irgendwie zu verschieben.
Informationen zu den verfügbaren Einstellungen finden Sie im Abschnitt Konfiguration.
Eine Liste der Erweiterungen der Drittanbieter finden Sie im Wiki.
mason-lspconfig.nvim - für die Verwendung bei lspconfig empfohlen
:h mason-commands
:Mason - Öffnet ein grafisches Statusfenster:MasonUpdate - Aktualisiert alle verwalteten Register:MasonInstall <package> ... - Installiert/installiert die bereitgestellten Pakete erneut:MasonUninstall <package> ... - Deinstalliert die bereitgestellten Pakete:MasonUninstallAll - deinstalliert alle Pakete:MasonLog - öffnet die mason.nvim -Protokolldatei in einem neuen Registerkartenfenster Das Mason-Kernpaketregister befindet sich in Mason-org/Mason-Registry. Bevor Pakete verwendet werden können, muss die Registrierung heruntergeladen werden. Dies erfolgt automatisch für Sie, wenn Sie die verschiedenen Mason -Befehle verwenden (z :MasonInstall ), kann aber auch mit dem Befehl :MasonUpdate manuell durchgeführt werden.
Wenn Sie die Lua-APIs von :h mason-registry.refresh() verwenden, um auf Pakete zuzugreifen, wird empfohlen :h mason-registry.update() die Funktionen zu verwenden. .
:h mason-settings
Sie können optional bestimmtes Verhalten von mason.nvim konfigurieren, wenn Sie die Funktion .setup() aufrufen. In der Standardkonfiguration finden Sie eine Liste aller verfügbaren Einstellungen.
Beispiel:
require ( " mason " ). setup ({
ui = {
icons = {
package_installed = " ✓ " ,
package_pending = " ➜ " ,
package_uninstalled = " ✗ "
}
}
}) --- @class MasonSettings
local DEFAULT_SETTINGS = {
--- @since 1.0.0
-- The directory in which to install packages.
install_root_dir = path . concat { vim . fn . stdpath " data " , " mason " },
--- @since 1.0.0
-- Where Mason should put its bin location in your PATH. Can be one of:
-- - "prepend" (default, Mason's bin location is put first in PATH)
-- - "append" (Mason's bin location is put at the end of PATH)
-- - "skip" (doesn't modify PATH)
--- @type ' "prepend" ' | ' "append" ' | ' "skip" '
PATH = " prepend " ,
--- @since 1.0.0
-- Controls to which degree logs are written to the log file. It's useful to set this to vim.log.levels.DEBUG when
-- debugging issues with package installations.
log_level = vim . log . levels . INFO ,
--- @since 1.0.0
-- Limit for the maximum amount of packages to be installed at the same time. Once this limit is reached, any further
-- packages that are requested to be installed will be put in a queue.
max_concurrent_installers = 4 ,
--- @since 1.0.0
-- [Advanced setting]
-- The registries to source packages from. Accepts multiple entries. Should a package with the same name exist in
-- multiple registries, the registry listed first will be used.
registries = {
" github:mason-org/mason-registry " ,
},
--- @since 1.0.0
-- The provider implementations to use for resolving supplementary package metadata (e.g., all available versions).
-- Accepts multiple entries, where later entries will be used as fallback should prior providers fail.
-- Builtin providers are:
-- - mason.providers.registry-api - uses the https://api.mason-registry.dev API
-- - mason.providers.client - uses only client-side tooling to resolve metadata
providers = {
" mason.providers.registry-api " ,
" mason.providers.client " ,
},
github = {
--- @since 1.0.0
-- The template URL to use when downloading assets from GitHub.
-- The placeholders are the following (in order):
-- 1. The repository (e.g. "rust-lang/rust-analyzer")
-- 2. The release version (e.g. "v0.3.0")
-- 3. The asset name (e.g. "rust-analyzer-v0.3.0-x86_64-unknown-linux-gnu.tar.gz")
download_url_template = " https://github.com/%s/releases/download/%s/%s " ,
},
pip = {
--- @since 1.0.0
-- Whether to upgrade pip to the latest version in the virtual environment before installing packages.
upgrade_pip = false ,
--- @since 1.0.0
-- These args will be added to `pip install` calls. Note that setting extra args might impact intended behavior
-- and is not recommended.
--
-- Example: { "--proxy", "https://proxyserver" }
install_args = {},
},
ui = {
--- @since 1.0.0
-- Whether to automatically check for new versions when opening the :Mason window.
check_outdated_packages_on_open = true ,
--- @since 1.0.0
-- The border to use for the UI window. Accepts same border values as |nvim_open_win()|.
border = " none " ,
--- @since 1.0.0
-- Width of the window. Accepts:
-- - Integer greater than 1 for fixed width.
-- - Float in the range of 0-1 for a percentage of screen width.
width = 0.8 ,
--- @since 1.0.0
-- Height of the window. Accepts:
-- - Integer greater than 1 for fixed height.
-- - Float in the range of 0-1 for a percentage of screen height.
height = 0.9 ,
icons = {
--- @since 1.0.0
-- The list icon to use for installed packages.
package_installed = " ◍ " ,
--- @since 1.0.0
-- The list icon to use for packages that are installing, or queued for installation.
package_pending = " ◍ " ,
--- @since 1.0.0
-- The list icon to use for packages that are not installed.
package_uninstalled = " ◍ " ,
},
keymaps = {
--- @since 1.0.0
-- Keymap to expand a package
toggle_package_expand = " <CR> " ,
--- @since 1.0.0
-- Keymap to install the package under the current cursor position
install_package = " i " ,
--- @since 1.0.0
-- Keymap to reinstall/update the package under the current cursor position
update_package = " u " ,
--- @since 1.0.0
-- Keymap to check for new version for the package under the current cursor position
check_package_version = " c " ,
--- @since 1.0.0
-- Keymap to update all installed packages
update_all_packages = " U " ,
--- @since 1.0.0
-- Keymap to check which installed packages are outdated
check_outdated_packages = " C " ,
--- @since 1.0.0
-- Keymap to uninstall a package
uninstall_package = " X " ,
--- @since 1.0.0
-- Keymap to cancel a package installation
cancel_installation = " <C-c> " ,
--- @since 1.0.0
-- Keymap to apply language filter
apply_language_filter = " <C-f> " ,
--- @since 1.1.0
-- Keymap to toggle viewing package installation log
toggle_package_install_log = " <CR> " ,
--- @since 1.8.0
-- Keymap to toggle the help view
toggle_help = " g? " ,
},
},
}:help mason.nvim ! 
