Сначала — своё окружениесвой модуль

Зачем начинать с .venv

На одном компьютере обычно лежит несколько проектов, и разным проектам нужны разные версии библиотек. Если ставить библиотеки в общее место, проекты оказываются связаны: обновление ради первого может сломать второй.

Виртуальное окружение отделяет установленные библиотеки проекта от остальных. Каталог .venv создаётся на основе уже установленного Python: внутри будет исполняемый файл Python или ссылка на него, служебные файлы и собственные пакеты. Это не отдельная операционная система.

Проект — все файлы и папки, из которых складывается программа: исходный код, проверки, документация, настройки и список зависимостей. Наш общий проект — Student Tools. Он посчитает среднюю оценку, сначала обычным текстом, а затем с помощью Rich. В каждой главе мы изменяем эту же папку.

01 / Откройте папку проекта

Распакуйте архив и возьмите из него папку python. Переименуйте её в student-tools. В VS Code выберите File → Open Folder и откройте именно её. Слева в Explorer должен быть виден main.py. Не создавайте проект внутри папки .venv.

Откройте Terminal → New Terminal. Текущая папка терминала должна быть student-tools. Если там другое место, перейдите командой cd "путь к student-tools". В этой книге подпись над командами всегда показывает, откуда их выполнять.

02 / Создайте окружение

Нужен установленный Python 3.10 или новее. Выберите вашу систему в переключателе сверху. Первая команда проверяет Python, вторая создаёт папку окружения. Если Windows не находит py, но команда python --version работает, используйте python -m venv .venv.

-m означает «выполни модуль», venv — встроенный модуль создания окружений, последнее .venv — имя создаваемой папки. Успешная команда может ничего не напечатать: проверьте появление каталога в Explorer.

Содержимое окружения создаёт Python. Свой код туда не переносим и служебные файлы руками не редактируем. .venv — принятое имя папки; .env обычно является файлом переменных окружения. Это разные вещи.

03 / Активируйте и проверьте

python -c "import sys; print(sys.executable); print(sys.prefix != sys.base_prefix)"

Первой строкой должен появиться путь внутрь student-tools/.venv, второй — True. Префикс (.venv) в приглашении полезен, но путь к интерпретатору — более надёжная проверка.

Что именно делает активация

Когда вы набираете python, терминал не угадывает, какую программу запустить: он идёт по списку папок из переменной PATH — сверху вниз — и берёт первый подходящий файл. Активация не создаёт и не перемещает ничего на диске. Она делает ровно одно: ставит папку .venv в начало этого списка для текущего терминала. С этого момента первым найденным python оказывается python из вашего окружения, а вместе с ним — и его собственный pip с его набором библиотек.

Отсюда три следствия. Активация действует только в том терминале, где вы её выполнили: соседняя вкладка продолжит работать с базовым Python. Команда deactivate возвращает прежний порядок поиска, но не удаляет окружение — папка остаётся на диске со всеми пакетами. И наконец, активация вообще не обязательна: можно ничего не активировать и каждый раз вызывать интерпретатор по полному пути, как в блоке для PowerShell ниже — результат будет тот же.

Зачем начинать с go.mod

На одном компьютере обычно лежит несколько проектов, и разным проектам нужны разные версии библиотек. Если версия выбирается «глобально», один проект придётся ломать ради другого. Go решает это иначе, чем Python: изоляцию даёт не отдельная папка внутри проекта, а файл, который лежит в его корне.

Модуль — это набор пакетов с общим именем, у которого в корне есть файл go.mod. В go.mod записано имя модуля, минимальная версия Go и точные версии всех зависимостей. Скачанный код библиотек хранится в общем кэше на вашем компьютере, но при сборке каждый проект берёт ровно те версии, которые названы в его собственном go.mod. Поэтому проекты не мешают друг другу и активировать ничего не нужно.

Проект — все файлы и папки, из которых складывается программа: исходный код, проверки, документация, настройки и список зависимостей. Наш общий проект — Student Tools. Он посчитает среднюю оценку, сначала обычным текстом, а затем цветным выводом через стороннюю библиотеку. В каждой главе мы изменяем эту же папку.

Если вы уже прошли ветку Python

Действия те же самые, отличаются имена файлов и команды. Слева — то, что вы делали в Python, справа — как это выглядит в Go.

01 / Откройте папку проекта

Распакуйте архив и возьмите из него папку go. Переименуйте её в student-tools. В VS Code выберите File → Open Folder и откройте именно её: слева в Explorer должен быть виден main.go. Открывать нужно папку самого проекта, а не папку уровнем выше — иначе команда go не найдёт go.mod.

Откройте Terminal → New Terminal. Текущая папка терминала должна быть student-tools. Если там другое место, перейдите командой cd "путь к student-tools". В этой книге подпись над командами всегда показывает, откуда их выполнять.

02 / Объявите модуль

Нужен установленный Go 1.21 или новее. Команды одинаковы во всех операционных системах — отдельный переключатель терминала здесь не нужен.

go version
go mod init example.com/student-tools

go mod init создаёт файл go.mod, а его аргумент — имя модуля. С этого имени будут начинаться все внутренние импорты проекта, поэтому оно должно быть уникальным. Обычно берут адрес будущего репозитория: github.com/ваш-логин/student-tools. Учебное example.com/student-tools тоже работает: Go не обращается по этому адресу, пока вы сами не попросите скачать такой модуль.

module example.com/student-tools

go 1.21

Пока в файле только две строки: имя модуля и версия Go, на которую рассчитан код. Раздела require нет — зависимостей ещё нет. Он появится сам в главе 2.3, когда мы подключим первую библиотеку.

Где тогда лежат библиотеки

Скачанные версии Go складывает в общий кэш модулей — одну папку на весь компьютер. Посмотреть её путь можно так:

go env GOMODCACHE
go env GOPATH

Внутри кэша каждая библиотека лежит вместе с номером версии в имени папки, поэтому две версии одной библиотеки существуют рядом. Проекту не нужна своя копия: ему достаточно назвать нужную версию в go.mod. Править файлы в кэше вручную нельзя — Go проверяет их контрольные суммы.

03 / Проверьте, что модуль виден

go list -m
go env GOMOD

Если вместо имени модуля вы видите сообщение go.mod file not found in current directory or any parent directory, значит терминал находится вне проекта или go mod init не выполнялся. Перейдите в папку с go.mod и повторите.

Что происходит вместо активации

Когда вы набираете go build или go run, команда не угадывает, какой проект вы имеете в виду. Она берёт текущую папку и идёт вверх по дереву каталогов, пока не найдёт go.mod. Найденный файл и задаёт границы модуля: его имя, набор пакетов и версии зависимостей. Никакой предварительной команды для этого не требуется.

Отсюда три следствия. Работает это в любом терминале — вкладки и новые окна ничего не теряют, потому что состояние хранится в файле, а не в сессии. Дальше: вложенные папки — часть того же модуля, отдельный go.mod внутри проекта создавать не нужно, поэтому в редакторе открывают папку с go.mod. И наконец, место установки самого Go роли не играет: один и тот же go обслуживает все ваши проекты, а различает их по go.mod.