n1ro°
RU

Компьютеры · Инструкция

Как передать --config-settings в pip install

Некоторые build backends принимают свои параметры. Вместо нестандартных переменных окружения pip умеет передавать пары K

Редакция N1RO · Проверено

Короткий ответ

Используйте `-C KEY=VALUE` или `--config-settings KEY=VALUE`, чтобы передать поддерживаемую настройку backend-сборки PEP 517.

Что делать

  1. 1. Проверьте документацию backend: Сначала узнайте точное имя поддерживаемого KEY.
  2. 2. Передайте параметр: Пример формы: `python -m pip install -C key=value .`.
  3. 3. Повторите ключ при необходимости: Для нескольких настроек передавайте `--config-settings` несколько раз.
  4. 4. Смотрите build log: Убедитесь, что backend распознал параметр и сборка изменилась именно ожидаемым образом.

Форма параметра

`python -m pip install -C key=value .` передаёт `key=value` build backend; имя ключа должно происходить из документации самого backend.

Важно

Pip только передаёт config setting; смысл конкретного KEY определяет build backend, поэтому не выдумывайте параметры.

Как понять, что всё сработало

  • Build backend принимает переданный `KEY=VALUE` без предупреждения о неизвестной настройке.
  • Поведение сборки изменилось так, как описано документацией backend, а не только потому, что команда завершилась с кодом 0.

Что учитывать

Pip только передаёт config setting; смысл конкретного KEY определяет build backend, поэтому не выдумывайте параметры.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. pip install). Пример и формулировки — редакция N1RO на 2026-09-18.