zoxide: как перестать вспоминать пути к проектам

Инструменты разработки · 25 сентября 2026 · 3 минуты чтения

Как подключить zoxide в zsh или bash и возвращаться в знакомые директории по короткому запросу.

Вы открыли терминал и хотите вернуться в проект, где работали вчера. Полный путь к нему помнить неудобно. zoxide запоминает директории (папки), которые вы уже посещали, и позволяет перейти в одну из них по части имени. Для этого служит команда z.

Инструкция ниже — для macOS. zsh и bash — командные оболочки: программы, которые принимают команды в терминале.

Установить и подключить

Если на Mac уже установлен Homebrew (программа для установки других программ из терминала), выполните:

brew install zoxide

Если не знаете, какая оболочка открыта, введите echo $0. Если ответ заканчивается на zsh или bash, выберите соответствующую строку ниже. Откройте указанный файл настроек в текстовом редакторе и добавьте одну строку в его конец. Знак ~ в пути означает вашу домашнюю директорию.

Таблицу можно прокрутить по горизонтали.

Это содержимое файла, а не команда для разового запуска. На Mac bash иногда читает ~/.bash_profile вместо ~/.bashrc: если проверка ниже не сработает, добавьте строку туда.

Откройте новое окно терминала и проверьте подключение:

type z

Если ответ сообщает, что z — функция оболочки, настройка работает. Если команда не найдена, проверьте строку в файле настроек и ещё раз откройте терминал.

Вернуться в знакомую директорию

В примерах ~/code/long-project-name — условный путь. Чтобы повторить действия, замените его и части имени в командах z на свой существующий проект. Команда cd переводит вас в указанную директорию. Зайдите туда хотя бы один раз:

cd ~/code/long-project-name

Теперь выйдите из проекта в домашнюю директорию и вернитесь по части имени:

cd ~z projectpwd

pwd покажет, где вы оказались. Путь должен оканчиваться на long-project-name. Если на компьютере несколько проектов со словом project, уточните запрос частями пути по порядку:

z code long

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

zoxide не ищет директории по всему диску: для первого посещения используйте cd. История посещений хранится на вашем компьютере. Если названия некоторых директорий не должны в неё попадать, настройте исключения до начала работы. Когда нужно каждый раз попадать строго в одно место, используйте cd с полным путём.

Термины

• Директория — папка на компьютере; терминал выполняет команды внутри текущей директории.
• Командная оболочка (shell) — программа, которая принимает команды в терминале; здесь показаны zsh и bash.

Источник

• README zoxide автора Ajeet D'Souza — установка, настройка zsh и bash, команды и исключения из истории.
• Алгоритм выбора — как zoxide сопоставляет запрос с путём и выбирает среди совпадений.

Автор: Данил Письменный · Дата: 25 сентября 2026