Go 1.27 научил go doc принимать суффикс @version: смотрим API пакета без добавления в go.modКратко · дайджест за 21 ноября
Кратко≈ 1 мин

Go 1.27 научил go doc принимать суффикс @version: смотрим API пакета без добавления в go.mod

Знакомая мелочь: хочешь глянуть API внешней библиотеки или свежей версии, а go doc ругается, что пакета нет в проекте. Приходилось лезть на pkg.go.dev или временно засорять go.mod. В Go 1.27 это починили: теперь go doc принимает суффикс @version у первого аргумента.

Если нужной версии нет на диске, Go сам скачает её в локальный module cache (GOMODCACHE) — общую папку кэша модулей, не трогая твой go.mod.

# Документация последней версии пакета
go doc go.starlark.net/syntax@latest

# Конкретный символ — вторым аргументом
go doc golang.org/x/tools/txtar@v0.13.0 FS

# Или через точку, но @version строго в конце аргумента
go doc golang.org/x/tools/txtar.FS@v0.13.0

Запись txtar@v0.13.0.FS не сработает: версию можно клеить только в хвост первого аргумента. Заодно в Go 1.27 у go doc появился флаг -ex для списка запускаемых примеров.

Идею из предложения #63696 хотели выпустить ещё в Go 1.23, но Расс Кокс притормозил её — ради чистой реализации пришлось перепахать внутреннюю механику команды. Помни только, что go doc pkg@version лишь читает API и не проверяет совместимость с проектом: после добавления зависимости всё равно прогони сборку и go test ./....

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 3