Команды go: go mod tidy, добавить отсутствующие и удалить неиспользуемые модули

go: updates to go.mod needed; to update it: go mod tidy

goland

go mod tidy [-e] [-v] [-go=version] [-compat=version]

tidy удостоверяется, что go.mod соответствует исходному коду в модуле. Он добавляет все недостающие модули, необходимые для построения пакетов и зависимостей текущего модуля, и удаляет неиспользуемые модули, которые не предоставляют никаких соответствующих пакетов. Он также добавляет все недостающие записи в go.sum и удаляет ненужные.

go.mod tidy работает путем рекурсивной загрузки всех пакетов в главном модуле и всех пакетов, которые они импортируют. Сюда входят пакеты, импортированные тестами (включая тесты в других модулях).

Обратите внимание, что «mod tidy» не будет рассматривать пакеты в главном модуле в каталогах с именем testdata или с именами, начинающимися с . или _, если только эти пакеты явно не импортированы другими пакетами.

Как только го мод тайди загрузит этот набор пакетов, он гарантирует, что каждый модуль, предоставляющий один или несколько пакетов, имеет директиву require в файле go.mod основного модуля или — если основной модуль находится на уровне go 1.16 или ниже — требуется другим требуемым модулем. go mod tidy добавит требование к последней версии каждого отсутствующего модуля. go mod tidy удалит директивы require для модулей, которые не предоставляют никаких пакетов в описанном выше наборе.

Го мод тайди также может добавлять или удалять // косвенные комментарии к директивам require. Косвенный комментарий // обозначает модуль, который не предоставляет пакет, импортированный пакетом в основном модуле.

Если установлен флаг -go, go mod tidy обновит директиву go до указанной версии, включив или отключив обрезку графика модуля и отложенную загрузку модуля (и добавив или удалив косвенные требования по мере необходимости) в соответствии с этой версией.

По умолчанию «mod tidy» проверяет, что выбранные версии модулей не изменяются, когда график модулей загружается версией Go, непосредственно предшествующей версии, указанной в директиве go. Проверенная версия на совместимость также может быть указана явно с помощью флага -compat.

Флаги go mod tidy

• -e (добавлен в Go 1.16) заставляет go mod tidy пытаться продолжить, несмотря на ошибки, возникающие при загрузке пакетов.
• -v заставляет tidy печатать информацию об удаленных модулях в стандартный вывод ошибки (std err).

Дополнительно по теме:

• Оригинал документации: го.дев
• Больше про го: Тег го)