Коротко о главном

Neovim развивает идеи Vim и делает конфигурацию понятнее для разработчиков. Встроенные API, терминал и диагностика позволяют собрать редактор без тяжёлой графической среды. В статье настроим init.lua, горячие клавиши и базовую диагностику. Материал подойдёт тем, кто уже знаком с основами Vim или готов начать с чистого листа.

Конфигурация на Lua легче читается и поддерживается, чем разрастающийся vimrc. Встроенный LSP-клиент упрощает автодополнение и переходы по коду. Асинхронная архитектура не блокирует редактор на больших проектах. Neovim также хорошо работает в tmux и по SSH.

Этот материал — быстрый старт по neovim. За 15 минут вы получите рабочую конфигурацию и поймёте, куда смотреть дальше.

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install neovim

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install neovim

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S neovim

Минимальная настройка

1. Проверьте версию и запустите Neovim

Neovim устанавливается отдельной командой nvim и не заменяет системный vim. Проверьте версию, чтобы понимать доступные параметры Lua API. Первый запуск создаст каталог конфигурации при необходимости.

nvim --version | head -n 1
nvim

2. Создайте init.lua

Конфигурация Neovim находится в ~/.config/nvim/init.lua. Блок из поля config задаёт отступы, нумерацию строк и лидер-клавишу. Сохраните файл и перезапустите nvim.

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

3. Запустите проверку здоровья

Команда :checkhealth показывает состояние провайдеров, LSP и внешних зависимостей. Это первый шаг при странном поведении редактора. Некоторые предупреждения нормальны, если соответствующая функция не используется.

nvim +checkhealth

4. Проверьте параметры и лидер-клавишу

Параметры можно посмотреть командой :set с вопросительным знаком. Лидер задан пробелом, поэтому сохранение по комбинации пробел и w вызывает :w. Убедитесь, что настройки загрузились без ошибок.

nvim
:set shiftwidth?
:set number?

Минимальный конфиг

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

-- ~/.config/nvim/init.lua
vim.opt.number = true
vim.opt.relativenumber = true
vim.opt.expandtab = true
vim.opt.shiftwidth = 4
vim.opt.tabstop = 4
vim.opt.ignorecase = true
vim.opt.smartcase = true
vim.opt.termguicolors = true
vim.g.mapleader = " "
vim.keymap.set("n", "<leader>w", ":w<CR>", { desc = "Сохранить файл" })

Шпаргалка по командам

  • Проверьте версию и запустите Neovim: nvim —version | head -n 1
  • Создайте init.lua: mkdir -p ~/.config/nvim
  • Запустите проверку здоровья: nvim +checkhealth
  • Проверьте параметры и лидер-клавишу: nvim
  • Работайте с буферами: nvim a.txt b.txt
  • Откройте встроенный терминал: :terminal

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 1. Запускайте nvim —clean, если нужно проверить поведение без пользовате

Запускайте nvim —clean, если нужно проверить поведение без пользовательской конфигурации.

Совет 2. Команда :checkhealth быстро показывает проблемы с провайдерами и внешн

Команда :checkhealth быстро показывает проблемы с провайдерами и внешними инструментами.

Совет 3. Начинайте конфигурацию с небольших блоков и проверяйте запуск после ка

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

Совет 4. Не копируйте чужие конфигурации целиком: они часто требуют конкретных

Не копируйте чужие конфигурации целиком: они часто требуют конкретных версий Neovim и плагинов.

Что дальше

Быстрый старт не означает «настроить навсегда». Когда базовый сценарий заработает, вернитесь к конфигурации и проверьте, что она переживёт перезагрузку: файлы на месте, служба включена в автозагрузку, путь к данным не зависит от текущего каталога.

Дальше имеет смысл разобраться с резервной копией и журналами neovim. Это не самая заметная часть работы, но именно она превращает эксперимент в инструмент, которым можно пользоваться каждый день.

Чек-лист

  • Команды из шпаргалки выполняются без ошибок после перезагрузки.
  • Пароли и токены не хранятся в истории команд и конфигурации в открытом виде.
  • Понятно, где смотреть логи и что считать признаком проблемы.
  • Есть копия конфигурации, которую можно восстановить.

Короткие ответы на частые вопросы

Нужно ли запускать всё от root?

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

Что делать, если после перезагрузки ничего не работает?

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

Как обновлять без сюрпризов?

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

Рабочие сценарии

Начните со справки: у neovim обычно есть страница man и примеры в описании. Затем повторите типичные операции на тестовых данных, а не на рабочих файлах.

man neovim 2>/dev/null | head -40
neovim --help 2>&1 | tail -30
# подготовить тестовые данные
mkdir -p /tmp/neovim-test && cd /tmp/neovim-test
printf 'alpha\nbeta\ngamma\n' > sample.txt

Фиксируйте рабочие команды в заметках или шпаргалке: так вы не будете заново искать синтаксис через месяц.

Итог

Этого достаточно, чтобы начать. Дальше углубляйтесь по мере задач: документация neovim станет понятнее, когда появится реальный сценарий использования.

Насколько публикация полезна?

Нажмите на звезду, чтобы оценить!

Средняя оценка 0 / 5. Количество оценок: 0

Оценок пока нет. Поставьте оценку первым.

Поделиться: Telegram ВКонтакте