Fundamentos de Configuración de Herramientas de Go

10 ejemplos para empezar con gopls y depuración - 7 básicos y 3 intermedios.

Prerrequisitos

Instala Go 1.26.x o posterior desde go.dev/dl.
Crea un módulo: mkdir tooling-demo && cd tooling-demo && go mod init example.com/tooling-demo.
Asegúrate de que $(go env GOPATH)/bin esté en tu PATH para que las herramientas instaladas se encuentren.

go install golang.org/x/tools/gopls@latest
go install github.com/go-delve/delve/cmd/dlv@latest
go install golang.org/x/vuln/cmd/govulncheck@latest
go install honnef.co/go/tools/cmd/staticcheck@latest

Ejemplos Básicos

1. Verificar que las herramientas principales estén en PATH

Confirma que los binarios del servidor de lenguaje y del depurador se resuelven antes de configurar un editor.

which gopls dlv
gopls version
dlv version

go install coloca los binarios en GOPATH/bin (a menudo ~/go/bin).
Los editores invocan gopls por nombre; una entrada PATH faltante se manifiesta como "language server not found".
Fija versiones en la documentación del equipo cuando la CI y las laptops deban coincidir.

Relacionado: Herramientas para Desarrolladores de Go: LSP, Depurador y Analizadores - cómo encajan las piezas

2. Configuración mínima de gopls para un módulo

Apunta gopls a la raíz de tu módulo y habilita el formateo al guardar en configuraciones estilo VS Code.

{
  "gopls": {
    "ui.semanticTokens": true,
    "formatting.gofumpt": true
  },
  "go.useLanguageServer": true
}

Abre la carpeta que contiene go.mod, no un directorio padre con módulos no relacionados.
formatting.gofumpt aplica un formateo más estricto que solo gofmt.
Otros editores exponen las mismas claves bajo la configuración de su cliente LSP.

Relacionado: gopls: Navegación, Refactorización y Diagnósticos - características del editor impulsadas por gopls

3. Ejecutar go vet en el módulo

go vet está integrado y no necesita instalación adicional.

go vet ./...

Detecta errores comunes (verbos de formato Printf, código inalcanzable, etiquetas de struct).
Ejecútalo en CI junto con las pruebas para una línea base sin configuración.
golangci-lint puede incluir verificaciones de vet, pero go vet sigue siendo útil en scripts rápidos.

Relacionado: staticcheck y golangci-lint en CI - superposición de analizadores en CI

4. Primera pasada de staticcheck

staticcheck encuentra problemas de corrección y rendimiento más allá de vet.

staticcheck ./...

Instálalo una vez con go install honnef.co/go/tools/cmd/staticcheck@latest.
Comienza con las verificaciones predeterminadas; añade -checks solo cuando necesites deshabilitar temporalmente una regla específica.
Trata los nuevos hallazgos como trabajo de relleno, no como bloqueadores inmediatos de CI en repositorios heredados.

Relacionado: staticcheck y golangci-lint en CI - severidad y líneas base

5. Escanear dependencias con govulncheck

Verifica si las CVE conocidas afectan al código que realmente importas.

govulncheck ./...

Utiliza la base de datos de vulnerabilidades de Go; no requiere clave API.
La salida distingue entre "módulo afectado presente" y "símbolo vulnerable alcanzable".
Añádelo a CI después de go test para que la descarga del módulo ya esté caliente.

Relacionado: govulncheck para Vulnerabilidades de Dependencias - triaje y conexión de CI

6. Depurar un programa simple con Delve

Inicia el depurador en main.go y detente en la entrada del programa.

# main.go: package main con func main()
dlv debug .

Dentro del REPL de dlv:

(dlv) break main.main
(dlv) continue
(dlv) next
(dlv) print x

dlv debug compila con símbolos de depuración e inicia el proceso bajo el depurador.
Usa continue, next y step como comandos estilo gdb.
quit finaliza la sesión.

Relacionado: Depuración con Delve - goroutines y adjuntar remotamente

7. Inicio rápido de golangci-lint

Ejecuta un conjunto de linters empaquetados con un solo comando.

# instalar una vez
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
 
golangci-lint run ./...

Crea o usa .golangci.yml cuando personalices los linters habilitados.
Retroalimentación local más rápida que habilitar cada analizador manualmente.
Haz coincidir la configuración de CI con el archivo confirmado en la raíz del repositorio.

Relacionado: staticcheck y golangci-lint en CI - configuración y adopción

Ejemplos Intermedios

8. Espacio de trabajo multi-módulo de gopls (`go.work`)

Cuando desarrollas una biblioteca y su consumidor juntos, usa un archivo de espacio de trabajo.

go work init ./app ./lib
go work use ./lib

Abre el directorio que contiene go.work en tu editor para que gopls resuelva las importaciones entre módulos.

Sin go.work, los reemplazos locales requieren directivas replace en go.mod.
gopls carga todos los módulos listados en go.work para referencias cruzadas.
La CI aún compila cada módulo; los espacios de trabajo son principalmente una herramienta de ergonomía local.

Relacionado: Herramientas para Desarrolladores de Go: LSP, Depurador y Analizadores - modelo de herramientas monorepo

9. Delve sin cabeza para adjuntar IDE

Ejecuta Delve escuchando en un puerto para que VS Code o GoLand se conecten remotamente.

dlv debug --headless --listen=:2345 --api-version=2 --accept-multiclient .

Las configuraciones de lanzamiento del IDE apuntan a localhost:2345 con la API v2.
Útil para depurar pruebas o binarios con indicadores de compilación personalizados.
No expongas el puerto públicamente; otorga control total del proceso.

Relacionado: Depuración con Delve - adjuntar remotamente y en contenedores

10. Sembrar una configuración de golangci-lint para CI

Confirma un .golangci.yml mínimo para que las laptops y la CI compartan reglas.

run:
  timeout: 5m
linters:
  enable:
    - govet
    - staticcheck
    - ineffassign
    - misspell
issues:
  max-issues-per-linter: 0
  max-same-issues: 0

Comienza con una lista pequeña de habilitados; amplía después de la limpieza de la línea base.
max-issues-per-linter: 0 falla la ejecución ante cualquier hallazgo; relaja durante la migración.
Combínalo con govulncheck en un trabajo de CI separado para CVE de dependencias.

Relacionado: Mejores Prácticas de gopls y Herramientas de Análisis - higiene del editor y CI

Versiones de la Pila: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, go fix modernizers - verificar parche en la compilación), chi (última versión - verificar en la compilación), gin (última versión - verificar en la compilación), echo (última versión - verificar en la compilación), google.golang.org/grpc (última versión - verificar en la compilación), sigs.k8s.io/controller-runtime (última versión - verificar en la compilación), kubebuilder (última versión - verificar en la compilación), tinygo (última versión - verificar objetivos de placa en la compilación), wazero (última versión - verificar en la compilación) y golangci-lint (última versión - verificar conjunto de linters en la compilación).

Prerrequisitos

Instala Go 1.26.x o posterior desde go.dev/dl.
Crea un módulo: mkdir tooling-demo && cd tooling-demo && go mod init example.com/tooling-demo.
Asegúrate de que $(go env GOPATH)/bin esté en tu PATH para que las herramientas instaladas se encuentren.

go install golang.org/x/tools/gopls@latest
go install github.com/go-delve/delve/cmd/dlv@latest
go install golang.org/x/vuln/cmd/govulncheck@latest
go install honnef.co/go/tools/cmd/staticcheck@latest

Ejemplos Básicos

1. Verificar que las herramientas principales estén en PATH

Confirma que los binarios del servidor de lenguaje y del depurador se resuelven antes de configurar un editor.

which gopls dlv
gopls version
dlv version

go install coloca los binarios en GOPATH/bin (a menudo ~/go/bin).
Los editores invocan gopls por nombre; una entrada PATH faltante se manifiesta como "language server not found".
Fija versiones en la documentación del equipo cuando la CI y las laptops deban coincidir.

Relacionado: Herramientas para Desarrolladores de Go: LSP, Depurador y Analizadores - cómo encajan las piezas

2. Configuración mínima de gopls para un módulo

Apunta gopls a la raíz de tu módulo y habilita el formateo al guardar en configuraciones estilo VS Code.

{
  "gopls": {
    "ui.semanticTokens": true,
    "formatting.gofumpt": true
  },
  "go.useLanguageServer": true
}

Abre la carpeta que contiene go.mod, no un directorio padre con módulos no relacionados.
formatting.gofumpt aplica un formateo más estricto que solo gofmt.
Otros editores exponen las mismas claves bajo la configuración de su cliente LSP.

Relacionado: gopls: Navegación, Refactorización y Diagnósticos - características del editor impulsadas por gopls

3. Ejecutar go vet en el módulo

go vet está integrado y no necesita instalación adicional.

go vet ./...

Detecta errores comunes (verbos de formato Printf, código inalcanzable, etiquetas de struct).
Ejecútalo en CI junto con las pruebas para una línea base sin configuración.
golangci-lint puede incluir verificaciones de vet, pero go vet sigue siendo útil en scripts rápidos.

Relacionado: staticcheck y golangci-lint en CI - superposición de analizadores en CI

4. Primera pasada de staticcheck

staticcheck encuentra problemas de corrección y rendimiento más allá de vet.

staticcheck ./...

Instálalo una vez con go install honnef.co/go/tools/cmd/staticcheck@latest.
Comienza con las verificaciones predeterminadas; añade -checks solo cuando necesites deshabilitar temporalmente una regla específica.
Trata los nuevos hallazgos como trabajo de relleno, no como bloqueadores inmediatos de CI en repositorios heredados.

Relacionado: staticcheck y golangci-lint en CI - severidad y líneas base

5. Escanear dependencias con govulncheck

Verifica si las CVE conocidas afectan al código que realmente importas.

govulncheck ./...

Utiliza la base de datos de vulnerabilidades de Go; no requiere clave API.
La salida distingue entre "módulo afectado presente" y "símbolo vulnerable alcanzable".
Añádelo a CI después de go test para que la descarga del módulo ya esté caliente.

Relacionado: govulncheck para Vulnerabilidades de Dependencias - triaje y conexión de CI

6. Depurar un programa simple con Delve

Inicia el depurador en main.go y detente en la entrada del programa.

# main.go: package main con func main()
dlv debug .

Dentro del REPL de dlv:

(dlv) break main.main
(dlv) continue
(dlv) next
(dlv) print x

dlv debug compila con símbolos de depuración e inicia el proceso bajo el depurador.
Usa continue, next y step como comandos estilo gdb.
quit finaliza la sesión.

Relacionado: Depuración con Delve - goroutines y adjuntar remotamente

7. Inicio rápido de golangci-lint

Ejecuta un conjunto de linters empaquetados con un solo comando.

# instalar una vez
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
 
golangci-lint run ./...

Crea o usa .golangci.yml cuando personalices los linters habilitados.
Retroalimentación local más rápida que habilitar cada analizador manualmente.
Haz coincidir la configuración de CI con el archivo confirmado en la raíz del repositorio.

Relacionado: staticcheck y golangci-lint en CI - configuración y adopción

Ejemplos Intermedios

8. Espacio de trabajo multi-módulo de gopls (`go.work`)

Cuando desarrollas una biblioteca y su consumidor juntos, usa un archivo de espacio de trabajo.

go work init ./app ./lib
go work use ./lib

Abre el directorio que contiene go.work en tu editor para que gopls resuelva las importaciones entre módulos.

Sin go.work, los reemplazos locales requieren directivas replace en go.mod.
gopls carga todos los módulos listados en go.work para referencias cruzadas.
La CI aún compila cada módulo; los espacios de trabajo son principalmente una herramienta de ergonomía local.

Relacionado: Herramientas para Desarrolladores de Go: LSP, Depurador y Analizadores - modelo de herramientas monorepo

9. Delve sin cabeza para adjuntar IDE

Ejecuta Delve escuchando en un puerto para que VS Code o GoLand se conecten remotamente.

dlv debug --headless --listen=:2345 --api-version=2 --accept-multiclient .

Las configuraciones de lanzamiento del IDE apuntan a localhost:2345 con la API v2.
Útil para depurar pruebas o binarios con indicadores de compilación personalizados.
No expongas el puerto públicamente; otorga control total del proceso.

Relacionado: Depuración con Delve - adjuntar remotamente y en contenedores

10. Sembrar una configuración de golangci-lint para CI

Confirma un .golangci.yml mínimo para que las laptops y la CI compartan reglas.

run:
  timeout: 5m
linters:
  enable:
    - govet
    - staticcheck
    - ineffassign
    - misspell
issues:
  max-issues-per-linter: 0
  max-same-issues: 0

Comienza con una lista pequeña de habilitados; amplía después de la limpieza de la línea base.
max-issues-per-linter: 0 falla la ejecución ante cualquier hallazgo; relaja durante la migración.
Combínalo con govulncheck en un trabajo de CI separado para CVE de dependencias.

Relacionado: Mejores Prácticas de gopls y Herramientas de Análisis - higiene del editor y CI

Versiones de la Pila: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, go fix modernizers - verificar parche en la compilación), chi (última versión - verificar en la compilación), gin (última versión - verificar en la compilación), echo (última versión - verificar en la compilación), google.golang.org/grpc (última versión - verificar en la compilación), sigs.k8s.io/controller-runtime (última versión - verificar en la compilación), kubebuilder (última versión - verificar en la compilación), tinygo (última versión - verificar objetivos de placa en la compilación), wazero (última versión - verificar en la compilación) y golangci-lint (última versión - verificar conjunto de linters en la compilación).

Fundamentos de Configuración de Herramientas de Go

Buscar en la documentación

Fundamentos de Configuración de Herramientas de Go