zsh: типичные ошибки и как их исправить

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

Zsh популярен у разработчиков, которые много работают в терминале и хотят удобное дополнение команд. Оболочка поддерживает рекурсивные шаблоны, расширенную историю и настраиваемые приглашения. В статье настроим zsh без сторонних фреймворков и разберём повседневные приёмы. Конфигурация будет работать в Debian, Ubuntu, Fedora и Arch.

Автодополнение zsh учитывает параметры команд, ветки Git и пути, что заметно сокращает ввод. Гибкий глоббинг позволяет выбирать файлы без сложных конструкций find. История и общие настройки делают работу в нескольких терминалах предсказуемой. При этом zsh остаётся полноценной оболочкой для скриптов и интерактивной работы.

zsh редко ломается сам по себе. Чаще проблема в неверной конфигурации, устаревшей версии или команде, скопированной без понимания. Разберём типичные сбои и способы их исправления.

Почему это происходит

Ошибки почти всегда связаны с контекстом: другая версия пакета, не тот пользователь, устаревший конфиг или команда из руководства для другой системы. zsh не исключение. Поэтому сначала фиксируем исходное состояние, затем меняем одну вещь за раз.

Типичные ошибки

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

1. При запуске появляется сообщение command not found: compinit.

Добавьте перед вызовом строку autoload -Uz compinit. Без неё функция compinit ещё не загружена в память оболочки.

2. Completion выводит предупреждение о небезопасных каталогах.

Запустите compaudit, проверьте перечисленные пути и исправьте владельца или права. Не отключайте проверку вслепую.

3. chsh завершается ошибкой, потому что путь отсутствует в /etc/shells.

Добавьте путь к zsh в /etc/shells через sudoedit и повторите chsh. Затем перезайдите в систему.

4. Команда с шаблоном завершается ошибкой no matches found.

Проверьте шаблон или временно включите setopt null_glob. Также убедитесь, что шаблон не должен остаться буквальной строкой.

Как настроить правильно

Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.

Установка

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

sudo apt install zsh

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

sudo dnf install zsh

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

sudo pacman -S zsh

1. Проверьте установку

Убедитесь, что zsh установлен и доступен в PATH. Запуск отдельной копии не меняет оболочку входа и позволяет спокойно осмотреться. Версия важна для поддержки новых параметров completion.

zsh --version
zsh

2. Сделайте zsh оболочкой входа

Команда chsh меняет оболочку входа для текущего пользователя. Путь нужно передать полностью, поэтому используйте command -v. После смены завершите сеанс и войдите снова, чтобы изменения вступили в силу.

command -v zsh
chsh -s "$(command -v zsh)"

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

Основные интерактивные настройки хранятся в ~/.zshrc. Создайте резервную копию перед редактированием и добавьте блок из поля config. compinit включает систему автодополнения, а setopt задаёт удобное поведение оболочки.

touch ~/.zshrc
cp ~/.zshrc ~/.zshrc.bak
vim ~/.zshrc

4. Загрузите настройки и проверьте completion

После сохранения выполните source ~/.zshrc и убедитесь, что файл не содержит ошибок. Затем наберите git sta и нажмите Tab: zsh должен предложить завершение команды. Если дополнение не появилось, проверьте, что compinit вызван после autoload.

source ~/.zshrc
zsh -ic 'echo $ZSH_VERSION'

Рабочий конфиг

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

# ~/.zshrc
autoload -Uz compinit
compinit
HISTFILE=~/.zsh_history
HISTSIZE=10000
SAVEHIST=10000
setopt autocd extendedglob hist_ignore_dups share_history
PROMPT='%n@%m:%~%# '
alias ll='ls -lah'

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

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

Совет 1. Проверяйте конфигурацию командой zsh -f: оболочка запустится без ~/.zs

Проверяйте конфигурацию командой zsh -f: оболочка запустится без ~/.zshrc и поможет отделить проблему настройки от системной.

Совет 2. Если completion работает нестабильно, удалите кэш ~/.zcompdump* и снов

Если completion работает нестабильно, удалите кэш ~/.zcompdump* и снова выполните compinit.

Совет 3. Запускайте compaudit после установки плагинов: утилита покажет каталог

Запускайте compaudit после установки плагинов: утилита покажет каталоги с небезопасными правами.

Совет 4. Помните, что массивы zsh индексируются с единицы, а не с нуля, если пе

Помните, что массивы zsh индексируются с единицы, а не с нуля, если переносите скрипты из Bash.

Профилактика

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

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

Итог

Большинство ошибок с zsh лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.