Как установить и настроить Neovim: конфигурация на Lua и первые плагины

Инструкция написана для Ubuntu 24.04, но шаги с конфигурацией одинаковы на macOS и Windows — различается только путь к папке настроек и способ установки. Права администратора нужны только для установки самой программы.

Установите Neovim

В Ubuntu и других системах на основе Debian редактор ставится из репозитория:

sudo apt install neovim

Проверьте версию командой nvim с ключом вывода версии. Если в репозитории лежит старый выпуск, часть современных плагинов работать не будет: тогда скачайте с сайта проекта самодостаточный файл приложения — он не требует установки и запускается сразу. В Windows тот же редактор ставится встроенным менеджером пакетов:

winget install Neovim.Neovim

Пройдите встроенный самоучитель

Запустите редактор командой nvim и откройте самоучитель: введите двоеточие, слово Tutor и нажмите Enter. Это текстовый курс на английском, который за полчаса объясняет главное — режимы, перемещение, удаление, копирование, сохранение и выход.

Не пропускайте этот шаг. Без понимания режимов любая дальнейшая настройка бесполезна: вы просто не сможете ввести в редакторе ни строки.

Создайте файл конфигурации

Neovim читает настройки из файла init.lua в своей папке конфигурации. В Linux и macOS это папка nvim внутри каталога с настройками пользователя, в Windows — папка nvim в локальных данных приложений. Создайте папку и пустой файл:

mkdir -p ~/.config/nvim && nvim ~/.config/nvim/init.lua

Задайте базовые настройки

Нажмите клавишу i, чтобы перейти в режим набора, и впишите несколько строк. Это номера строк, отступы пробелами, подсветка найденного и поиск без учёта регистра — минимум, с которым редактор становится удобным.

vim.opt.number = true
vim.opt.expandtab = true
vim.opt.tabstop = 2
vim.opt.shiftwidth = 2
vim.opt.ignorecase = true
vim.opt.smartcase = true
vim.g.mapleader = ' '

Последняя строка назначает пробел клавишей-предводителем: с неё начинаются собственные сочетания клавиш. Нажмите Esc, затем введите двоеточие, буквы wq и Enter — файл сохранится, редактор закроется. Запустите его снова: номера строк должны появиться.

Поставьте менеджер плагинов

Плагины в Neovim не ставятся из магазина: их скачивает менеджер, который вы прописываете в конфигурации. Выберите один из популярных менеджеров и скопируйте в init.lua тот блок установки, который указан в его собственной документации, — он скачивает менеджер при первом запуске сам.

Для работы менеджера в системе должны быть установлены git и утилита загрузки файлов. Проверьте их заранее, иначе при запуске редактор покажет ошибку скачивания.

Добавьте первые плагины

Начните с небольшого набора, который закрывает ежедневные задачи:

• тему оформления — без неё подсветка в терминале выглядит бедно;
• дерево файлов проекта — чтобы видеть структуру папок слева;
• нечёткий поиск по файлам и по тексту проекта — самый полезный плагин из всех;
• строку состояния — показывает текущий режим, файл и ветку Git;
• плагин для Git — подсвечивает изменённые строки на полях.

После правки конфигурации перезапустите редактор: менеджер скачает плагины и покажет ход установки. Добавляйте их по одному и проверяйте, что всё работает, — так проще найти причину, если редактор начнёт запускаться с ошибкой.

Подключите подсказки по коду

Автодополнение и подсказки об ошибках дают языковые серверы. Нужный сервер устанавливается в систему отдельно — например, вместе с инструментами того языка, на котором вы пишете. После этого его включают в конфигурации несколькими строками.

Точный вид этих строк зависит от версии редактора, поэтому берите пример из встроенной справки: введите двоеточие, слово help, пробел и слово lsp. Справка открывается в редакторе и всегда соответствует установленной версии — это надёжнее, чем статьи в интернете.

Проверьте состояние редактора

Введите двоеточие и слово checkhealth. Neovim проверит сам себя и покажет отчёт: какие программы не найдены, какие плагины настроены неправильно, хватает ли поддержки буфера обмена и шрифтов. Разберите красные строки по одной — там же написано, что нужно установить.

Готово: редактор работает, конфигурация лежит в одном файле, плагины ставятся менеджером. Сохраните папку конфигурации в своём репозитории — на другом компьютере достаточно будет её скопировать.

Если что-то пошло не так