Shell и окружение

Команда source

Выполнить файл в текущей shell-сессии

Linux · примеры для Bash · команда выполняется на выбранном сервере

Когда использовать source

Команда source выполняет доверенный файл в текущей оболочке. Она может менять переменные, функции и рабочий каталог, а также запускать любые разрешённые этой учётной записи действия. Это выполнение кода, а не простое чтение настроек.

Синтаксис

source ФАЙЛ [АРГУМЕНТЫ…]

Квадратные скобки обозначают необязательные аргументы, многоточие — повторение. Замените условные имена файлов, пользователей и серверов своими значениями.

Основные параметры и аргументы

ФАЙЛ
Путь к сценарию, исполняемому в текущей оболочке.
. ФАЙЛ
POSIX-совместимая форма подключения файла.

Примеры использования

Подключить доверенный файл настроек

source ./project.env

Сценарий среды выполняется в текущей оболочке со всеми действиями, разрешенными для этой учетной записи.

Использовать POSIX-форму

. ./project.env

Команда dot выполняет операцию поиска оболочки с использованием выбранного файла.

Проверить синтаксис перед подключением

bash -n ./project.env

Bash проверяет синтаксис без выполнения скрипта; успешный синтаксис не доказывает его безопасность.

Особенности и ограничения

  • source исполняет команды, а не просто читает пары ключ-значение. Подключайте только доверенный файл.
  • Изменения переменных, каталога и функций сохраняются в текущей оболочке; source не поддерживается всеми /bin/sh.

Частые вопросы и решение проблем

Безопасно ли source загруженный файл среды?

Только если вы доверяете и просмотрели его. Код оболочки может выполнять произвольные команды, даже если имя файла предполагает, что он содержит только настройки.

Почему после этого переменные становятся недоступны дочерним программам?

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

Подробная справка

Параметры могут зависеть от установленной версии и дистрибутива. Проверьте справку с помощью следующей команды: help source.