Как добавить папку в PATH

Справочник · Командная строка Linux · 2 минуты чтения

PATH — список папок через двоеточие, в которых оболочка ищет команды. Папку в него добавляет строка export PATH=…, а куда её вписать, зависит от того, где папка должна действовать.

Как добавить

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

Только в этом терминале

Bash

export PATH="$HOME/bin:$PATH"

Настройка действует до закрытия окна.

Дальше — для всех случаев

Навсегда для себячерез ~/.bashrc

Допишите ту же строку в конец ~/.bashrc и примените:

Bash

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Одинарные кавычки в echo нужны, чтобы в файл попал сам текст $HOME и $PATH, а не их нынешние значения. В новых окнах терминала настройка действует сама.

Дальше — для всех случаев

Для всех пользователейчерез /etc/profile.d

Создайте файл в папке /etc/profile.d/:

Bash

sudo nano /etc/profile.d/myapp.sh

С одной строкой:

Bash

export PATH="$PATH:/opt/myapp/bin"

Файлы из /etc/profile.d/ читаются при входе в систему, поэтому изменение заработает после нового входа (выйдите и войдите снова или переподключитесь по SSH).

Во всех трёх случаях $PATH в строке сохраняет весь прежний список, а новая папка встаёт перед ним или после него — чем это различается, сказано ниже.

Проверить

Bash

echo $PATH
which myscript.sh

В первом выводе должна появиться ваша папка, второй покажет полный путь к программе, если оболочка её находит (вместо myscript.sh — имя вашей программы из этой папки).

Папка в начале или в конце

export PATH="$HOME/bin:$PATH" — ваша папка проверяется первой: программа с тем же именем, что и системная, запустится из вашей папки.
export PATH="$PATH:$HOME/bin" — ваша папка последней: системные программы важнее.

Для своих скриптов обычно всё равно; если не уверены — ставьте в конец.

Подводные камни

Не забывайте $PATH. Строка export PATH="$HOME/bin" заменит весь список одной папкой: перестанут находиться ls, nano и другие команды. Если это случилось, верните стандартный список на время и исправьте файл: export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin, затем nano ~/.bashrc.

sudo не видит программу. У sudo свой список папок, ваш PATH он не берёт. Запускайте по полному пути: sudo /opt/myapp/bin/myapp.
Не работает по SSH или в cron. По SSH bash при входе читает ~/.profile (в Ubuntu, Debian и Mint он сам подключает ~/.bashrc, но не всегда — если есть ~/.bash_profile, читается он). У cron свой короткий PATH: в расписании пишите полные пути.
Тильда в кавычках. В "~/bin:$PATH" знак ~ не заменится на домашнюю папку. Пишите $HOME — как в примерах.
/etc/environment тоже задаёт PATH для всех, но это не скрипт: там нельзя писать export и подставлять $PATH — только полный список папок целиком.