$ sudo teach IT
Модуль 2 · Свой проект · Урок 2.5

Версия Python

Вы научитесь смотреть, какие Python есть, и выбирать версию для своего проекта.

Теория + практика~5 минутНовичок

Наш баннер живёт на Python 3.15. А если нужна другая версия? С uv это пара команд.

Какие Python есть и как поставить ещё один

Сначала посмотрим, что uv уже нашёл на вашем компьютере:

Терминал
$ uv python list --only-installed
Вывод
cpython-3.15.2-macos-aarch64-none    ~/.local/bin/python3.15
cpython-3.13.2-macos-aarch64-none    /usr/local/bin/python3.13
cpython-3.9.6-macos-aarch64-none     /usr/bin/python3

Это фрагмент, у вас строки будут свои. Без --only-installed uv покажет и версии, которые можно скачать. Нужной нет? Скачиваем:

Терминал
$ uv python install 3.14
Вывод
Installed Python 3.14.10
 + cpython-3.14.10-macos-aarch64-none (python3.14)

Всё. Появилась ещё одна копия Python, системный Python uv не трогает.

Два файла про версию

Версия Python записана в проекте в двух местах, и роли у них разные. Как с поездом: .python-version — это билет на конкретный поезд («едем на этой версии сейчас»), а requires-python — правило перевозчика («подойдёт любой поезд не старше этого»).

Текст · .python-version
3.15
TOML · pyproject.toml (фрагмент)
requires-python = ">=3.15"

Разбор по строкам

  • .python-version — какую версию uv берёт для запуска прямо сейчас: 3.15.
  • requires-python = ">=3.15" — какие версии проект вообще допускает: 3.15 и новее.

Меняем версию: uv python pin

Команда uv python pin перезаписывает .python-version. Попробуем выбрать 3.14:

Терминал
$ uv python pin 3.14
Вывод
error: The requested Python version `3.14` is incompatible with the project `requires-python` value of `>=3.15`.

Ошибка по делу: проект не допускает 3.14. Сначала разрешаем её в pyproject.toml:

TOML · pyproject.toml (фрагмент)
requires-python = ">=3.14"

Теперь пин проходит, а uv run сам пересоздаёт .venv под новую версию:

Терминал
$ uv python pin 3.14
$ uv run python --version
Вывод
Updated `.python-version` from `3.15` -> `3.14`
Using CPython 3.14.10
Removed virtual environment at: .venv
Creating virtual environment at: .venv
Installed 7 packages
Python 3.14.10

Вернуть 3.15 — так же: requires-python обратно в ">=3.15", затем uv python pin 3.15.

Ошибка incompatible

Если uv python pin пишет incompatible, поменяйте requires-python в pyproject.toml и повторите команду.

Попробуйте

  • В папке проекта выполните uv run python --version — увидите версию из .python-version.
  • Выйдите из папки проекта (cd ..) и повторите: вне проекта uv берёт любой найденный Python, версия может отличаться.

Что запомнить

  • uv python list показывает, какие Python есть, а uv python install 3.14 скачивает ещё один.
  • .python-version — версия «сейчас», requires-python — какие версии проект допускает.
  • uv python pin 3.14 меняет версию проекта, но только в рамках requires-python.

Модуль закончен. Дальше — uv в работе: инструменты, старые проекты, Docker.

На следующий урок