Знакомая мелочь: хочешь глянуть 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 ./....
