Go Modules Reference

Canonical reference for module files, version selection, workspaces, replacements, vendoring, and module download behavior.

• Author: Go Team
• Authority: primary
• Kind: reference
• URL: https://go.dev/ref/mod

What it covers

• go.mod and go.work directives
• minimal version selection and replacements
• vendoring and module download behavior

Why authoritative

Canonical Go reference for module semantics and module-aware commands.

Use when

• what does the Go modules reference say here
• how do go.work and replace work
• how does Go choose module versions

Keywords

• go modules reference, go.mod, go.work, replace, vendoring, minimal version selection

Used by

• modules
• go-workspaces
• replace-directives
• private-modules-and-proxies
• vendoring
• go-and-toolchain-directives
• minimal-version-selection