`cmdline.md`

488 строк · 45.9 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.6/using/cmdline.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 1. Командная строка и окружение89Интерпретатор CPython сканирует командную строку и окружение на предмет различных настроек.1011**Особенности реализации CPython:** схемы командной строки других реализаций могут отличаться. Для получения дополнительных сведений см. [Альтернативные реализации](https://python-all.ru/3.6/reference/introduction.html#implementations).1213## 1.1. Командная строка1415При запуске Python можно указать любые из этих опций:1617```sh18python [-bBdEhiIOqsSuvVWx?] [-c command | -m module-name | script | - ] [args]19```2021Наиболее распространённый вариант использования – это простой запуск скрипта:2223```sh24python myscript.py25```2627### 1.1.1. Опции интерфейса2829Интерфейс интерпретатора напоминает интерфейс командной оболочки UNIX, но предоставляет дополнительные способы запуска:3031- При вызове с подключённым к tty-устройству стандартным вводом интерпретатор выводит приглашение для команд и выполняет их, пока не будет прочитан EOF (символ конца файла; в UNIX его можно ввести с помощью `Ctrl-D`, а в Windows – с помощью `Ctrl-Z, Enter`).32- При вызове с именем файла в качестве аргумента или с файлом в качестве стандартного ввода он читает и выполняет скрипт из этого файла.33- При вызове с именем каталога в качестве аргумента он читает и выполняет соответствующий скрипт из этого каталога.34- При вызове с `-c command` выполняется инструкция(и) Python, переданная как *command*. Здесь *command* может содержать несколько инструкций, разделённых переводами строк. Начальные пробелы в инструкциях Python значимы!35- При вызове с `-m module-name` указанный модуль находится в пути поиска модулей Python и выполняется как скрипт.3637В неинтерактивном режиме весь ввод анализируется до его выполнения.3839При указании опции интерфейса список параметров, обрабатываемых интерпретатором, завершается, и все последующие аргументы попадают в [`sys.argv`](https://python-all.ru/3.6/library/sys.html#sys.argv) – первый элемент (индекс ноль, `sys.argv[0]`) является строкой, указывающей на источник программы.4041#### `-c <command>`4243Выполняет код Python, указанный в *command*. *command* может содержать одну или несколько инструкций, разделённых переводами строк; начальные пробелы, как и в обычном коде модуля, имеют значение.4445Если указана эта опция, первый элемент [`sys.argv`](https://python-all.ru/3.6/library/sys.html#sys.argv) будет равен `"-c"`, а текущий каталог будет добавлен в начало [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path) (что позволяет импортировать модули из этого каталога как модули верхнего уровня).4647#### `-m <module-name>`4849Ищет [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path) указанный модуль и выполняет его содержимое как модуль [`__main__`](https://python-all.ru/3.6/library/__main__.html#module-__main__).5051Поскольку аргумент является именем *модуля*, не следует указывать расширение файла (`.py`). Имя модуля должно быть допустимым абсолютным именем модуля Python, но реализация может не всегда это проверять (например, может позволить использовать имя, содержащее дефис).5253Имена пакетов (включая пакеты пространств имён) также допускаются. Если вместо обычного модуля указано имя пакета, интерпретатор выполнит `<pkg>.__main__` в качестве главного модуля. Это поведение намеренно аналогично обработке каталогов и zip-файлов, которые передаются интерпретатору в качестве аргумента скрипта.5455> **Примечание**56>57> Эту опцию нельзя использовать со встроенными модулями и модулями расширения, написанными на C, поскольку у них нет файлов модулей Python. Однако её можно использовать для предварительно скомпилированных модулей, даже если исходный файл недоступен.5859Если эта опция указана, первый элемент [`sys.argv`](https://python-all.ru/3.6/library/sys.html#sys.argv) будет содержать полный путь к файлу модуля (пока файл модуля находится, первый элемент будет установлен в `"-m"`). Как и в случае с опцией [`-c`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-c), текущий каталог будет добавлен в начало [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path).6061Многие модули стандартной библиотеки содержат код, который вызывается при их выполнении в качестве скрипта. Примером может служить модуль [`timeit`](https://python-all.ru/3.6/library/timeit.html#module-timeit):6263```sh64python -mtimeit -s 'setup here' 'benchmarked code here'65python -mtimeit -h # подробнее66```6768> **См. также**69>70> **[`runpy.run_module()`](https://python-all.ru/3.6/library/runpy.html#runpy.run_module)**71>72> Эквивалентная функциональность, доступная напрямую из кода Python73>74> [**PEP 338**](https://python-all.ru/3.6/using/cmdline.html) – Выполнение модулей как сценариев7576Изменено в версии 3.1: Укажите имя пакета, чтобы запустить подмодуль `__main__`.7778Изменено в версии 3.4: также поддерживаются пространственные пакеты7980#### `-`8182Читает команды из стандартного ввода ([`sys.stdin`](https://python-all.ru/3.6/library/sys.html#sys.stdin)). Если стандартный ввод является терминалом, подразумевается [`-i`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-i).8384Если указана эта опция, первым элементом [`sys.argv`](https://python-all.ru/3.6/library/sys.html#sys.argv) будет `"-"`, а текущий каталог будет добавлен в начало [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path).8586#### `<script>`8788Выполняет код Python, содержащийся в *скрипте*, который должен быть файловым путем (абсолютным или относительным), указывающим на файл Python, каталог с файлом `__main__.py` или ZIP-файл, содержащий файл `__main__.py`.8990Если указана эта опция, первым элементом [`sys.argv`](https://python-all.ru/3.6/library/sys.html#sys.argv) будет имя скрипта, заданное в командной строке.9192Если имя скрипта указывает непосредственно на файл Python, каталог, содержащий этот файл, добавляется в начало [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path), а сам файл выполняется как модуль [`__main__`](https://python-all.ru/3.6/library/__main__.html#module-__main__).9394Если имя скрипта ссылается на каталог или ZIP-файл, имя скрипта добавляется в начало [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path), а файл `__main__.py` в этом расположении выполняется как модуль [`__main__`](https://python-all.ru/3.6/library/__main__.html#module-__main__).9596> **См. также**97>98> **[`runpy.run_path()`](https://python-all.ru/3.6/library/runpy.html#runpy.run_path)**99>100> Эквивалентная функциональность, доступная напрямую из кода Python101102Если не указана опция интерфейса, подразумевается [`-i`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-i), `sys.argv[0]` является пустой строкой (`""`), а текущий каталог будет добавлен в начало [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path). Кроме того, автодополнение по табуляции и редактирование истории автоматически включаются, если это доступно на вашей платформе (см. [конфигурацию Readline](https://python-all.ru/3.6/library/site.html#rlcompleter-config)).103104> **См. также**105>106> [Запуск интерпретатора](https://python-all.ru/3.6/tutorial/interpreter.html#tut-invoking)107108Изменено в версии 3.4: Автоматическое включение автодополнения по табуляции и редактирования истории.109110### 1.1.2. Общие опции111112#### `-?`113114#### `-h`115116#### `--help`117118Выводит краткое описание всех параметров командной строки.119120#### `-V`121122#### `--version`123124Выводит номер версии Python и завершает работу. Пример вывода:125126```text127Python 3.6.0b2+128```129130При указании дважды выводит более подробную информацию о сборке, например:131132```text133Python 3.6.0b2+ (3.6:84a3c5003510+, Oct 26 2016, 02:33:55)134[GCC 6.2.0 20161005]135```136137Новое в версии 3.6: Опция `-VV`.138139### 1.1.3. Прочие опции140141#### `-b`142143Выдаёт предупреждение при сравнении [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) или [`bytearray`](https://python-all.ru/3.6/library/stdtypes.html#bytearray) с [`str`](https://python-all.ru/3.6/library/stdtypes.html#str) или [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) с [`int`](https://python-all.ru/3.6/library/functions.html#int). Выдаёт ошибку, если параметр указан дважды (`-bb`).144145Изменено в версии 3.5: Влияет на сравнения [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) с [`int`](https://python-all.ru/3.6/library/functions.html#int).146147#### `-B`148149Если указан, Python не будет пытаться записывать файлы `.pyc` при импорте исходных модулей. См. также [`PYTHONDONTWRITEBYTECODE`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONDONTWRITEBYTECODE).150151#### `-d`152153Включить отладочный вывод парсера (только для волшебников, в зависимости от опций компиляции).\\nСм. также [`PYTHONDEBUG`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONDEBUG).154155#### `-E`156157Игнорировать все переменные окружения `PYTHON*`, например [`PYTHONPATH`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONPATH) и [`PYTHONHOME`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONHOME), которые могут быть установлены.158159#### `-i`160161Когда в качестве первого аргумента передан сценарий или используется опция [`-c`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-c), интерактивный режим запускается после выполнения сценария или команды, даже если [`sys.stdin`](https://python-all.ru/3.6/library/sys.html#sys.stdin) не выглядит как терминал. Файл [`PYTHONSTARTUP`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONSTARTUP) при этом не читается.162163Это может быть полезно для проверки глобальных переменных или трассировки стека, когда скрипт вызывает исключение. См. также [`PYTHONINSPECT`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONINSPECT).164165#### `-I`166167Запускает Python в изолированном режиме. Это также подразумевает -E и -s. В изолированном режиме [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path) не содержит ни каталога скрипта, ни каталога site-packages пользователя. Все переменные окружения `PYTHON*` также игнорируются. Могут быть наложены дополнительные ограничения, чтобы предотвратить внедрение пользователем вредоносного кода.168169Новое в версии 3.4.170171#### `-O`172173Удаляет операторы assert и любой код, зависящий от значения [`__debug__`](https://python-all.ru/3.6/library/constants.html#__debug__). Дополняет имя файла для скомпилированных ([байт-код](https://python-all.ru/3.6/glossary.html#term-bytecode)) файлов, добавляя `.opt-1` перед расширением `.pyc` (см. [**PEP 488**](https://python-all.ru/3.6/using/cmdline.html)). См. также [`PYTHONOPTIMIZE`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONOPTIMIZE).174175Изменено в версии 3.5: Изменяет имена файлов `.pyc` в соответствии с [**PEP 488**](https://python-all.ru/3.6/using/cmdline.html).176177#### `-OO`178179Выполняет [`-O`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-o), а также отбрасывает строки документации. Дополняет имя файла для скомпилированных ([байт-код](https://python-all.ru/3.6/glossary.html#term-bytecode)) файлов, добавляя `.opt-2` перед расширением `.pyc` (см. [**PEP 488**](https://python-all.ru/3.6/using/cmdline.html)).180181Изменено в версии 3.5: Изменяет имена файлов `.pyc` в соответствии с [**PEP 488**](https://python-all.ru/3.6/using/cmdline.html).182183#### `-q`184185Не выводить сообщения об авторских правах и версии, даже в интерактивном режиме.186187Новое в версии 3.2.188189#### `-R`190191Сохранено для совместимости. Начиная с Python 3.3, рандомизация хешей включена по умолчанию.192193В предыдущих версиях Python этот параметр включает рандомизацию хэшей, так что значения [`__hash__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__hash__) для str, bytes и datetime «солятся» непредсказуемым случайным значением. Хотя они остаются постоянными в пределах одного процесса Python, они непредсказуемы при повторных запусках Python.194195Хэш-рандомизация предназначена для защиты от отказа в обслуживании, вызванного тщательно подобранными входными данными, которые используют наихудшую производительность построения словаря (сложность O(n²)). Подробнее см. [http://www.ocert.org/advisories/ocert-2011-003.html](https://python-all.ru/3.6/using/cmdline.html).196197[`PYTHONHASHSEED`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONHASHSEED) позволяет задать фиксированное значение для секрета начального значения хеша.198199Новое в версии 3.2.3.200201#### `-s`202203Не добавляет [`user site-packages directory`](https://python-all.ru/3.6/library/site.html#site.USER_SITE) в [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path).204205> **См. также**206>207> [**PEP 370**](https://python-all.ru/3.6/using/cmdline.html) – Каталог site-packages для каждого пользователя208209#### `-S`210211Отключает импорт модуля [`site`](https://python-all.ru/3.6/library/site.html#module-site) и связанные с ним site-зависимые манипуляции с [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path). Также отключает эти манипуляции, если [`site`](https://python-all.ru/3.6/library/site.html#module-site) явно импортирован позже (для их выполнения следует вызвать [`site.main()`](https://python-all.ru/3.6/library/site.html#site.main)).212213#### `-u`214215Принудительно сделать двоичный слой потоков stdout и stderr (доступный\\nкак их атрибут `buffer`) небуферизованным. Текстовый слой ввода-вывода\\nпо-прежнему будет буферизован построчно при выводе в консоль или\\nпоблочно при перенаправлении в неинтерактивный файл.216217См. также [`PYTHONUNBUFFERED`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONUNBUFFERED).218219#### `-v`220221Выводит сообщение при каждой инициализации модуля, показывая место (имя файла или встроенный модуль), из которого он загружается. При указании дважды (`-vv`) выводит сообщение для каждого файла, проверяемого при поиске модуля. Также предоставляет информацию об очистке модуля при завершении. См. также [`PYTHONVERBOSE`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONVERBOSE).222223#### `-W arg`224225Управление предупреждениями. Механизм предупреждений Python по умолчанию выводит предупреждения в [`sys.stderr`](https://python-all.ru/3.6/library/sys.html#sys.stderr). Типичное предупреждение имеет следующий вид:226227```text228file:line: category: message229```230231По умолчанию каждое предупреждение выводится один раз для каждой строки исходного кода, в которой оно возникает. Этот параметр управляет частотой вывода предупреждений.232233Может быть указано несколько параметров [`-W`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-w); если предупреждение соответствует более чем одному параметру, выполняется действие последнего подходящего параметра. Недопустимые параметры [`-W`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-w) игнорируются (однако при выдаче первого предупреждения выводится сообщение о недопустимых параметрах).234235Предупреждениями также можно управлять из программы Python с помощью\\nмодуля [`warnings`](https://python-all.ru/3.6/library/warnings.html#module-warnings).236237Простейшая форма аргумента – одна из следующих строк действий (или\\nуникальное сокращение):238239**`ignore`**240241Игнорировать все предупреждения.242243**`default`**244245Явно запросить поведение по умолчанию (вывод каждого предупреждения один раз на\\nстроку исходного кода).246247**`all`**248249Выводить предупреждение при каждом его появлении (это может породить много сообщений, если\\nпредупреждение вызывается многократно для одной и той же строки, например, внутри\\nцикла).250251**`module`**252253Выводить каждое предупреждение только при первом появлении в каждом модуле.254255**`once`**256257Выводить каждое предупреждение только при первом появлении в программе.258259**`error`**260261Возбуждать исключение вместо вывода предупреждения.262263Полная форма аргумента:264265```sh266action:message:category:module:line267```268269Здесь *action* (действие) как описано выше, но применяется только к сообщениям, соответствующим\\nостальным полям. Пустые поля соответствуют любым значениям; конечные пустые поля можно\\nопускать. Поле *message* соответствует началу выводимого сообщения\\nпредупреждения; сравнение нечувствительно к регистру. Поле *category* соответствует\\nкатегории предупреждения. Это должно быть имя класса; при сравнении проверяется,\\nявляется ли фактическая категория предупреждения сообщения подклассом указанной\\nкатегории. Необходимо указывать полное имя класса. Поле *module* соответствует\\n(полному) имени модуля; сравнение чувствительно к регистру. Поле *line*\\nсоответствует номеру строки; ноль соответствует всем номерам строк и, таким образом,\\nэквивалентен отсутствующему номеру строки.270271> **См. также**272>273> [`warnings`](https://python-all.ru/3.6/library/warnings.html#module-warnings) – модуль warnings274>275> [**PEP 230**](https://python-all.ru/3.6/using/cmdline.html) – инфраструктура предупреждений276>277> [`PYTHONWARNINGS`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONWARNINGS)278279#### `-x`280281Пропускает первую строку исходного файла, позволяя использовать не-юниксовые формы `#!cmd`. Это предназначено только для специфического хака DOS.282283#### `-X`284285Зарезервировано для различных опций, специфичных для реализации. В настоящее время CPython определяет следующие возможные значения:286287- `-X faulthandler` для включения [`faulthandler`](https://python-all.ru/3.6/library/faulthandler.html#module-faulthandler);288- `-X showrefcount` вывод общего количества ссылок и числа использованных блоков памяти при завершении программы или после каждого оператора в интерактивном интерпретаторе. Работает только в отладочных сборках.289- `-X tracemalloc` для начала трассировки выделений памяти Python с помощью модуля [`tracemalloc`](https://python-all.ru/3.6/library/tracemalloc.html#module-tracemalloc). По умолчанию в обратной трассировке сохраняется только самый последний кадр. Используйте `-X tracemalloc=NFRAME`, чтобы начать трассировку с лимитом обратной трассировки в *NFRAME* кадров. Дополнительную информацию см. в [`tracemalloc.start()`](https://python-all.ru/3.6/library/tracemalloc.html#tracemalloc.start).290- `-X showalloccount` для вывода общего количества выделенных объектов для каждого типа при завершении программы. Это работает только при сборке Python с определённым `COUNT_ALLOCS`.291292Он также позволяет передавать произвольные значения и извлекать их через словарь [`sys._xoptions`](https://python-all.ru/3.6/library/sys.html#sys._xoptions).293294Изменено в версии 3.2: Был добавлен параметр [`-X`](https://python-all.ru/3.6/using/cmdline.html#id5).295296Новое в версии 3.3: Параметр `-X faulthandler`.297298Новое в версии 3.4: Параметры `-X showrefcount` и `-X tracemalloc`.299300Новое в версии 3.6: Опция `-X showalloccount`.301302### 1.1.4. Параметры, которые не стоит использовать303304#### `-J`305306Зарезервировано для [Jython](https://python-all.ru/3.6/using/cmdline.html).307308## 1.2. Переменные окружения309310Эти переменные окружения влияют на поведение Python, они обрабатываются до параметров командной строки, кроме -E или -I. Принято, что параметры командной строки переопределяют переменные окружения в случае конфликта.311312**`PYTHONHOME`**313314Изменяет расположение стандартных библиотек Python. По умолчанию библиотеки ищутся в `prefix/lib/pythonversion` и `exec_prefix/lib/pythonversion`, где `prefix` и `exec_prefix` – это каталоги, зависящие от установки; оба по умолчанию имеют значение `/usr/local`.315316Когда [`PYTHONHOME`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONHOME) установлен в один каталог, его значение заменяет оба `prefix` и `exec_prefix`. Чтобы указать для них разные значения, установите [`PYTHONHOME`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONHOME) в `prefix:exec_prefix`.317318**`PYTHONPATH`**319320Дополняет путь поиска модулей по умолчанию. Формат такой же, как у `PATH` оболочки: один или несколько путей к каталогам, разделённых [`os.pathsep`](https://python-all.ru/3.6/library/os.html#os.pathsep) (например, двоеточиями в Unix или точкой с запятой в Windows). Несуществующие каталоги игнорируются без предупреждения.321322В дополнение к обычным каталогам, отдельные записи [`PYTHONPATH`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONPATH) могут ссылаться на zip-файлы, содержащие чистые модули Python (в исходной или скомпилированной форме). Модули расширений не могут быть импортированы из zip-файлов.323324Путь поиска по умолчанию зависит от установки, но обычно начинается с `prefix/lib/pythonversion` (см. [`PYTHONHOME`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONHOME) выше). Он *всегда* добавляется к [`PYTHONPATH`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONPATH).325326Дополнительный каталог будет вставлен в путь поиска перед [`PYTHONPATH`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONPATH), как описано выше в разделе [Параметры интерфейса](https://python-all.ru/3.6/using/cmdline.html#using-on-interface-options). Путь поиска можно изменять из программы Python как переменную [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path).327328**`PYTHONSTARTUP`**329330Если это имя читаемого файла, команды Python из этого файла выполняются перед отображением первого приглашения в интерактивном режиме. Файл выполняется в том же пространстве имён, что и интерактивные команды, поэтому определённые или импортированные в нём объекты могут использоваться без уточнения в интерактивном сеансе. Также в этом файле можно изменить приглашения [`sys.ps1`](https://python-all.ru/3.6/library/sys.html#sys.ps1) и [`sys.ps2`](https://python-all.ru/3.6/library/sys.html#sys.ps2) и хук [`sys.__interactivehook__`](https://python-all.ru/3.6/library/sys.html#sys.__interactivehook__).331332**`PYTHONOPTIMIZE`**333334Если эта переменная установлена в непустую строку, это эквивалентно указанию опции [`-O`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-o). Если установлено целое число, это эквивалентно указанию [`-O`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-o) несколько раз.335336**`PYTHONDEBUG`**337338Если эта переменная установлена в непустую строку, это эквивалентно указанию опции [`-d`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-d). Если установлено целое число, это эквивалентно указанию [`-d`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-d) несколько раз.339340**`PYTHONINSPECT`**341342Если эта переменная установлена в непустую строку, это эквивалентно указанию опции [`-i`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-i).343344Эта переменная также может быть изменена кодом Python с помощью [`os.environ`](https://python-all.ru/3.6/library/os.html#os.environ), чтобы принудительно включить режим инспектирования при завершении программы.345346**`PYTHONUNBUFFERED`**347348Если эта переменная установлена в непустую строку, это эквивалентно указанию опции [`-u`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-u).349350**`PYTHONVERBOSE`**351352Если эта переменная установлена в непустую строку, это эквивалентно указанию опции [`-v`](https://python-all.ru/3.6/using/cmdline.html#id4). Если установлено целое число, это эквивалентно указанию [`-v`](https://python-all.ru/3.6/using/cmdline.html#id4) несколько раз.353354**`PYTHONCASEOK`**355356Если переменная установлена, Python игнорирует регистр в операторах [`import`](https://python-all.ru/3.6/reference/simple_stmts.html#import). Это работает только в Windows и OS X.357358**`PYTHONDONTWRITEBYTECODE`**359360Если эта переменная установлена в непустую строку, Python не будет пытаться записывать файлы `.pyc` при импорте исходных модулей. Это эквивалентно указанию опции [`-B`](https://python-all.ru/3.6/using/cmdline.html#id1).361362**`PYTHONHASHSEED`**363364Если эта переменная не установлена или установлена в `random`, для инициализации хэшей объектов str, bytes и datetime используется случайное значение.365366Если [`PYTHONHASHSEED`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONHASHSEED) установлено в целое число, оно используется как фиксированное начальное значение для генерации hash() для типов, охваченных рандомизацией хешей.367368Его цель – обеспечить воспроизводимое хеширование, например, для самотестирования самого интерпретатора, или чтобы позволить кластеру процессов Python обмениваться значениями хешей.369370Целое число должно быть десятичным числом в диапазоне \[0, 4294967295\]. Указание значения 0 отключит рандомизацию хешей.371372Новое в версии 3.2.3.373374**`PYTHONIOENCODING`**375376Если эта переменная установлена до запуска интерпретатора, она переопределяет кодировку, используемую для stdin/stdout/stderr, в синтаксисе `encodingname:errorhandler`. Обе части `encodingname` и `:errorhandler` необязательны и имеют то же значение, что и в [`str.encode()`](https://python-all.ru/3.6/library/stdtypes.html#str.encode).377378Для stderr часть `:errorhandler` игнорируется; обработчик всегда будет `'backslashreplace'`.379380Изменено в версии 3.4: Часть `encodingname` теперь необязательна.381382Изменено в версии 3.6: В Windows кодировка, указанная этой переменной, игнорируется для интерактивных буферов консоли, если также не указана [`PYTHONLEGACYWINDOWSSTDIO`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONLEGACYWINDOWSSTDIO). Файлы и каналы, перенаправленные через стандартные потоки, не затрагиваются.383384**`PYTHONNOUSERSITE`**385386Если эта переменная установлена, Python не будет добавлять [`user site-packages directory`](https://python-all.ru/3.6/library/site.html#site.USER_SITE) в [`sys.path`](https://python-all.ru/3.6/library/sys.html#sys.path).387388> **См. также**389>390> [**PEP 370**](https://python-all.ru/3.6/using/cmdline.html) – Каталог site-packages для каждого пользователя391392**`PYTHONUSERBASE`**393394Определяет [`user base directory`](https://python-all.ru/3.6/library/site.html#site.USER_BASE), который используется для вычисления пути [`user site-packages directory`](https://python-all.ru/3.6/library/site.html#site.USER_SITE) и [путей установки Distutils](https://python-all.ru/3.6/install/index.html#inst-alt-install-user) для `python setup.py install --user`.395396> **См. также**397>398> [**PEP 370**](https://python-all.ru/3.6/using/cmdline.html) – Каталог site-packages для каждого пользователя399400**`PYTHONEXECUTABLE`**401402Если эта переменная окружения установлена, `sys.argv[0]` будет установлено в её значение вместо значения, полученного через C runtime. Работает только в Mac OS X.403404**`PYTHONWARNINGS`**405406Это эквивалентно опции [`-W`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-w). Если присвоена строка, разделённая\\nзапятыми, это эквивалентно указанию [`-W`](https://python-all.ru/3.6/using/cmdline.html#cmdoption-w) несколько\\nраз.407408**`PYTHONFAULTHANDLER`**409410Если эта переменная окружения установлена в непустую строку, [`faulthandler.enable()`](https://python-all.ru/3.6/library/faulthandler.html#faulthandler.enable) вызывается при запуске: устанавливается обработчик сигналов `SIGSEGV`, `SIGFPE`, `SIGABRT`, `SIGBUS` и `SIGILL` для дампа обратной трассировки Python. Это эквивалентно параметру [`-X`](https://python-all.ru/3.6/using/cmdline.html#id5) `faulthandler`.411412Новое в версии 3.3.413414**`PYTHONTRACEMALLOC`**415416Если эта переменная окружения установлена в непустую строку, начинается трассировка выделений памяти Python с помощью модуля [`tracemalloc`](https://python-all.ru/3.6/library/tracemalloc.html#module-tracemalloc). Значение переменной – максимальное количество кадров, сохраняемых в обратной трассировке. Например, `PYTHONTRACEMALLOC=1` сохраняет только самый последний кадр. Дополнительную информацию см. в [`tracemalloc.start()`](https://python-all.ru/3.6/library/tracemalloc.html#tracemalloc.start).417418Новое в версии 3.4.419420**`PYTHONASYNCIODEBUG`**421422Если эта переменная окружения установлена в непустую строку, включает [режим отладки](https://python-all.ru/3.6/library/asyncio-dev.html#asyncio-debug-mode) модуля [`asyncio`](https://python-all.ru/3.6/library/asyncio.html#module-asyncio).423424Новое в версии 3.4.425426**`PYTHONMALLOC`**427428Устанавливает аллокаторы памяти Python и/или добавляет отладочные хуки.429430Устанавливает семейство аллокаторов памяти, используемых Python:431432- `malloc`: использовать функцию `malloc()` библиотеки C для всех областей ([`PYMEM_DOMAIN_RAW`](https://python-all.ru/3.6/c-api/memory.html#c.PYMEM_DOMAIN_RAW), [`PYMEM_DOMAIN_MEM`](https://python-all.ru/3.6/c-api/memory.html#c.PYMEM_DOMAIN_MEM), [`PYMEM_DOMAIN_OBJ`](https://python-all.ru/3.6/c-api/memory.html#c.PYMEM_DOMAIN_OBJ)).433- `pymalloc`: использовать [аллокатор pymalloc](https://python-all.ru/3.6/c-api/memory.html#pymalloc) для областей [`PYMEM_DOMAIN_MEM`](https://python-all.ru/3.6/c-api/memory.html#c.PYMEM_DOMAIN_MEM) и [`PYMEM_DOMAIN_OBJ`](https://python-all.ru/3.6/c-api/memory.html#c.PYMEM_DOMAIN_OBJ), а функцию `malloc()` – для области [`PYMEM_DOMAIN_RAW`](https://python-all.ru/3.6/c-api/memory.html#c.PYMEM_DOMAIN_RAW).434435Установить отладочные перехватчики:436437- `debug`: установить отладочные хуки поверх распределителя памяти по умолчанию438- `malloc_debug`: то же, что и `malloc`, но также устанавливает отладочные хуки439- `pymalloc_debug`: то же, что и `pymalloc`, но также устанавливает отладочные хуки440441Когда Python скомпилирован в режиме выпуска, по умолчанию используется `pymalloc`. При\\nкомпиляции в режиме отладки по умолчанию используется `pymalloc_debug`, а отладочные хуки применяются\\nавтоматически.442443Если Python настроен без поддержки `pymalloc`, то `pymalloc` и\\n`pymalloc_debug` недоступны; по умолчанию используется `malloc` в режиме выпуска\\nи `malloc_debug` в режиме отладки.444445Смотрите функцию [`PyMem_SetupDebugHooks()`](https://python-all.ru/3.6/c-api/memory.html#c.PyMem_SetupDebugHooks) для отладочных перехватчиков на распределителях памяти Python.446447Новое в версии 3.6.448449**`PYTHONMALLOCSTATS`**450451Если установлена в непустую строку, Python будет выводить статистику [аллокатора памяти pymalloc](https://python-all.ru/3.6/c-api/memory.html#pymalloc) каждый раз, когда создаётся новая арена объекта pymalloc, а также при завершении работы.452453Эта переменная игнорируется, если переменная окружения [`PYTHONMALLOC`](https://python-all.ru/3.6/using/cmdline.html#envvar-PYTHONMALLOC) используется для принудительного выбора аллокатора `malloc()` из библиотеки C, или если Python скомпилирован без поддержки `pymalloc`.454455Изменено в версии 3.6: Теперь эту переменную можно также использовать в Python, скомпилированном в режиме релиза. Теперь она не действует, если установлена в пустую строку.456457**`PYTHONLEGACYWINDOWSFSENCODING`**458459Если установлено в непустую строку, кодировка файловой системы по умолчанию и режим обработки ошибок вернутся к значениям до версии 3.6: 'mbcs' и 'replace' соответственно. В противном случае используются новые значения по умолчанию: 'utf-8' и 'surrogatepass'.460461Это также можно включить во время выполнения с помощью [`sys._enablelegacywindowsfsencoding()`](https://python-all.ru/3.6/library/sys.html#sys._enablelegacywindowsfsencoding).462463Доступность: Windows464465Новое в версии 3.6: Подробности см. в [**PEP 529**](https://python-all.ru/3.6/using/cmdline.html).466467**`PYTHONLEGACYWINDOWSSTDIO`**468469Если задана непустая строка, не использует новые средства чтения и записи консоли. Это означает, что символы Unicode будут кодироваться в соответствии с активной кодовой страницей консоли, а не с помощью utf-8.470471Эта переменная игнорируется, если стандартные потоки перенаправлены (в файлы или каналы), а не ссылаются на буферы консоли.472473Доступность: Windows474475Новое в версии 3.6.476477### 1.2.1. Переменные режима отладки478479Установка этих переменных работает только в отладочной сборке Python, то есть если Python был сконфигурирован с параметром сборки `--with-pydebug`.480481**`PYTHONTHREADDEBUG`**482483Если установлено, Python будет выводить отладочную информацию о потоках.484485**`PYTHONDUMPREFS`**486487Если установлено, Python будет выгружать объекты и счетчики ссылок, все еще живые после завершения работы интерпретатора.488