Как обновить все зависимости Go модуля одной командой?

Команда для массового обновления зависимостей в Go

Для обновления всех зависимостей в Go модуле используется команда go get -u ./.... Однако важно понимать её нюансы:

go get -u ./...

Эта команда обновляет только те пакеты, которые напрямую импортируются в вашем коде. Если у вас есть транзитивные зависимости (зависимости ваших зависимостей), они не будут затронуты. Для полного обновления всех зависимостей, включая транзитивные, используйте флаг -t для тестовых зависимостей:

go get -u -t ./...

Как это работает на практике?

1. Команда проверяет все пакеты в вашем проекте (включая тестовые файлы)
2. Для каждого импортируемого пакета ищет последнюю минорную версию (не мажорную, чтобы избежать breaking changes)
3. Обновляет go.mod и go.sum файлы
4. Загружает новые версии в кеш

Пример полного обновления

Предположим, у вас такой go.mod:

module my-project

go 1.21

require (
    github.com/gin-gonic/gin v1.7.7
    github.com/go-sql-driver/mysql v1.6.0
)

Выполняем:

go get -u -t ./...

После этого go.mod может выглядеть так:

require (
    github.com/gin-gonic/gin v1.9.1
    github.com/go-sql-driver/mysql v1.7.1
)

Как избежать проблем с несовместимостью?

• Используйте go mod tidy после обновления — эта команда удаляет неиспользуемые зависимости и добавляет недостающие:

go mod tidy

• Проверяйте изменения в go.sum — если там появились неожиданные версии, это может указывать на конфликты
• Используйте go mod verify для проверки целостности зависимостей:

go mod verify

• Обновляйте с умом — если проект стабилен, лучше обновлять зависимости по одной и тестировать каждую:

go get -u github.com/gin-gonic/gin
go test ./...

Продвинутый метод: go-mod-upgrade

Существует сторонний инструмент go-mod-upgrade, который даёт интерактивный интерфейс для выбора версий:

go install github.com/oligot/go-mod-upgrade@latest
go-mod-upgrade

Он показывает список зависимостей с доступными обновлениями и позволяет выбрать, какие версии установить. Это особенно полезно, когда нужно избежать мажорных обновлений (например, с v1 на v2).

Что делать, если после обновления всё сломалось?

1. Проверьте go.sum — возможно, конфликт версий
2. Откатите конкретную зависимость:

go get github.com/gin-gonic/gin@v1.7.7

3. Используйте go mod why -m github.com/gin-gonic/gin чтобы понять, почему эта версия была выбрана
4. В крайнем случае удалите go.sum и выполните go mod tidy для пересборки

Главное правило: всегда делайте коммит перед массовым обновлением, чтобы можно было легко откатиться.

# Makefile
.PHONY: update-deps

update-deps:
    @echo "Обновление всех зависимостей..."
    go get -u -t ./...
    go mod tidy
    go mod verify
    @echo "Готово!"

go list -u -m -json all | go-mod-outdated

go install github.com/psampaz/go-mod-outdated@latest
go list -u -m -json all | go-mod-outdated -update -direct