Rivalry2

HTML Diff

1 added 1 removed

Original 2026-01-01

Modified 2026-02-26

1 В этом уроке мы познакомимся с модулями в Go и узнаем, зачем они нужны. Вы научитесь работать с внешними зависимостями в Go, а также добавлять и удалять модули. Эти знания помогут более гибко настраивать окружение.

2 <h2>Что такое модули</h2>

3 В Go модулем принято называть любое приложение, которое можно опубликовать, версионировать, импортировать или скачать. С помощью модулей мы можем управлять зависимостями.

4 Добавим в пример с Hello, Hexlet пакет для логгирования. В коде это будет выглядеть так:

5 Но чтобы это код запустился, надо создать модуль.

6 <h2>Как создать модуль</h2>

7 Чтобы превратить папку с кодом в Go-модуль, можно использовать команду go mod init:

8 Команда сгенерировалаgo.modфайл со следующим содержимым:

9 Файл начинается с объявления имени модуля (module github.com/hexlet/hello-hexlet). Это уникальный идентификатор, по которому модуль хранится в индексе модулей Go. Обычно в качестве имени модуля указывают его адрес в репозитории.

10 Далее указывается минимальная совместимая версия языка (go 1.23) и список зависимостей. Пока список зависимостей пуст. Вывод команды создания модуля подсказывает нам, что добавить зависимости можно командой go mod tidy:

11 Команда go mod tidy проверяет импорты в коде, загружает недостающие зависимости и удаляет лишние. Файлgo.modобновился и теперь включает в себя раздел с зависимостями:

12 Также появился файлgo.sum:

13 Оба файла обновляются при каждом добавлении или удалении зависимости:

14 <ul><li>Файлgo.modвключает путь до модуля и его версию</li>

15 <li>Файлgo.sumдобавляет по две записи на каждую зависимость:<ul><li>Первая запись с названием модуля, его версией и хэш-суммой</li>

16 <li>Вторая запись с хэш-суммойgo.modфайла модуля</li>

17 </ul></li>

18 </ul>Наконец, после установки зависимостей мы можем запусть наш код:

19 Зависимость установилась, и код заработал.

20 <h2>Как менять версии зависимостей</h2>

21 Модули предоставляют инструменты для работы с разными версиями пакетов. По умолчанию Go добавляет последнюю доступную версию пакета. Чтобы проверить, какие еще версии пакета доступны, используем команду go list:

22 По умолчанию команда go list выдает адрес текущего пакета, по которому его можно импортировать. В примере выше мы использовали два флага:

23 <ul><li>-m указывает, что нас интересует только модуль, а не его пакеты</li>

24 <li>--versions указывает все возможные для скачивания версии пакета</li>

25 </ul>Чтобы изменить версию, используем команду go get:

26 <h2>Как удалять зависимости</h2>

27 - Удалить зависимость из проекта довольно просто - достаточно удалить импорт этой зависимости из кода и запустить go mod tidy. В обновленном файлеgo.modэтого модуля больше не будет.

27 + Удалить зависимость из проекта довольно просто - достаточно удалить импорт этой зависимости из кода и запустить go mod tidy. В обновленном файлеgo.modэтог�� модуля больше не будет.

28 <h2>Выводы</h2>

29 <ul><li>Модуль - это само приложение, в корне которого находится файлgo.modсо списком зависимостей текущего модуля</li>

30 <li>Модуль создается командой go mod init</li>

31 <li>Чтобы добавить зависимость в модуль или изменить ее версию, используйте команду go get</li>

32 <li>Чтобы удалить зависимость, достаточно убрать ссылку на нее в коде и вызвать go mod tidy</li>

33 </ul>