Recursos Oficiales: go.dev, pkg.go.dev y el Blog de Go
La documentación oficial de Go está dividida en un pequeño conjunto de superficies de confianza.
//
Busca en todas las páginas de la documentación
La documentación oficial de Go está dividida en un pequeño conjunto de superficies de confianza.
Esta hoja de trucos mapea cada URL a la pregunta que responde para que dejes de adivinar si buscar primero en blogs, GitHub o Stack Overflow.
go.mod.| Superficie | Pregunta que responde | URL |
|---|---|---|
| Página de inicio de go.dev | ¿Dónde descargo Go y encuentro rutas de aprendizaje? | https://go.dev |
| Descargas | ¿Qué archivo tarball o instalador coincide con mi SO/arquitectura? | https://go.dev/dl/ |
| Especificación del lenguaje | ¿Es este programa Go válido? | https://go.dev/ref/spec |
| Go Efectivo | ¿Cuál es el estilo idiomático de Go? | https://go.dev/doc/effective_go |
| Go Tour | ¿Cómo aprendo la sintaxis interactivamente? | https://go.dev/tour/ |
| Playground | ¿Puedo compartir una repro mínima sin configuración? | https://go.dev/play/ |
| pkg.go.dev | ¿Qué hace este símbolo en la versión V? | https://pkg.go.dev |
| Blog de Go | ¿Por qué el equipo envió este cambio? | https://go.dev/blog |
| Notas de lanzamiento | ¿Qué se rompe o se ajusta en Go 1.N? | https://go.dev/doc/go1.N |
| Seguridad | ¿Dónde están los anuncios de seguridad? | https://go.dev/security |
| Base de datos de vulnerabilidades | ¿Está mi grafo de módulos afectado por una CVE? | https://vuln.go.dev |
| Tarea | Ruta del navegador | Equivalente CLI |
|---|---|---|
| Paquete de la biblioteca estándar | pkg.go.dev/fmt | go doc fmt |
| Módulo en una versión | pkg.go.dev/mod/path@v1.2.3 | go doc mod/path@v1.2.3 |
| Verificación de licencia | Página del módulo → Pestaña Licencias | go list -m -json path@v1.2.3 |
| Grafo de importadores | Página del módulo → Importado por | go list -deps ./... localmente |
| APIs obsoletas | Insignia de símbolo en la página de documentación | go vet ./... después de actualizar |
| Documento | Cuándo abrir | Acción del SME |
|---|---|---|
doc/go1.N | Al planificar un pequeño ajuste | Archivar ADR de actualización con secciones marcadas |
doc/godebug | El comportamiento del runtime difiere después del despliegue | Registrar claves GODEBUG de reversión |
doc/modules | Autenticación de módulos, retractaciones, espacios de trabajo | Alinear política de CI y proxy |
doc/telemetry | Debates sobre la opción de telemetría | Decidir la política de la organización por separado del código |
cmd/go | Desviación de scripts después de la actualización | Actualizar Makefile y GitHub Actions |
cmd/vet | Nuevos fallos de CI sin errores de compilación | Habilitar o documentar excepciones |
| Necesidad | Leer primero | Por qué |
|---|---|---|
| Se añadió un analizador de verificación | Notas de lanzamiento, sección Herramientas | Texto exacto de habilitación y fallo |
| Narrativa del rediseño del GC | Blog de Go + Notas de lanzamiento, Runtime | El blog explica las compensaciones; las notas listan los valores predeterminados |
| Nuevo paquete de la biblioteca estándar | Anuncio del blog | Patrones de migración y ejemplos |
| Alcance de la corrección de seguridad | Página de Seguridad + Notas de lanzamiento | Vinculación de CVE y versiones afectadas |
| Propuesta aceptada | Issue de GitHub + blog si es importante | El issue tiene el texto de la decisión final |
| Recurso | URL | Uso |
|---|---|---|
| Repositorio principal de Go | https://github.com/golang/go | Issues, propuestas, hitos |
| Consulta de etiquetas de propuestas | https://github.com/golang/go/issues?q=label%3AProposal | Filtrar hilos de diseño activos |
| Documentación del proceso de propuestas | https://go.dev/s/proposal | Pasos para archivar e iterar |
| Gerrit (contribuciones) | https://go-review.googlesource.com | Revisar CLs upstream |
| Repositorios x/* | https://github.com/orgs/golang/repositories | Subsistemas separados del árbol principal |
# Abre la documentación de un símbolo en la terminal
go doc net/http.Server.Shutdown
# Descarga la documentación del módulo para máquinas sin conexión (opcional)
go install golang.org/x/tools/cmd/godoc@latest
# Lista las versiones de módulos disponibles
go list -m -versions example.com/lib
# Comprueba el informe de vulnerabilidad del espacio de trabajo
govulncheck ./...| Paso | Recurso | Límite de tiempo |
|---|---|---|
| 1 | doc/go1.N Introducción + Puertos | 10 min |
| 2 | Herramientas + go vet | 15 min |
| 3 | Runtime / GC / GODEBUG | 15 min |
| 4 | Paquetes de la biblioteca estándar que importas | 20 min |
| 5 | Publicación del blog si está enlazada desde las notas | 10 min |
| 6 | Actualizar hojas de trucos internas | 30 min |
go.dev es el dominio canónico actual.
Los enlaces antiguos de golang.org suelen redirigir; prefiere go.dev en la documentación nueva.
pkg.go.dev soporta versiones de módulos, licencias y contexto de vulnerabilidad.
godoc.org es obsoleto para muchos flujos de trabajo.
Úsalas solo para estudiar.
Verifica los símbolos y el comportamiento en pkg.go.dev en tu versión fijada.
Consulta go.dev/ref/mod#workspaces enlazado desde el centro de documentación de módulos.
Las características importantes a menudo reciben publicaciones en el blog cada versión menor.
Las versiones de parche pueden ser solo notas; aún así, lee los avisos de seguridad con prontitud.
El playground no puede abrir redes arbitrarias ni todos los paquetes.
Mantén las repros solo con la biblioteca estándar o comparte repros basadas en módulos en los issues en su lugar.
Enlaza a URLs de pkg.go.dev versionadas y al ancla específica de doc/go1.N.
Incluye la fecha en que las revisaste.
Sí, para muchos paquetes.
Aún así, confirma con go doc local cuando las etiquetas controlen tus matrices de compilación.
En go.dev bajo documentación y la página doc/telemetry.
Distinto de la documentación de observabilidad de aplicaciones en tus servicios.
golangci-lint envuelve go vet y analizadores de terceros.
Cuando vet cambie en las notas de lanzamiento, actualiza también la documentación de la configuración del linter.
Versiones de pila: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, go fix modernizadores - verifica el parche en la compilación), chi (última versión - verifica en la compilación), gin (última versión - verifica en la compilación), echo (última versión - verifica en la compilación), google.golang.org/grpc (última versión - verifica en la compilación), sigs.k8s.io/controller-runtime (última versión - verifica en la compilación), kubebuilder (última versión - verifica en la compilación), tinygo (última versión - verifica los objetivos de la placa en la compilación), wazero (última versión - verifica en la compilación) y golangci-lint (última versión - verifica el conjunto de linters en la compilación).
Revisado por Chris St. John·Última actualización: 16 jul 2026