La IA escribe código muerto? La herramienta deadcode del equipo de Go lo encuentra con un solo comando

Los agentes de codificación de IA son excelentes generando código, pero también son excelentes dejando código muerto: funciones sin usar, ramas inalcanzables y ayudantes huérfanos que inflan tu base de código y confunden a futuros lectores. La herramienta deadcode del equipo de Go lo encuentra en un solo comando.

¿Qué es deadcode?

deadcode es una herramienta oficial de Go (parte de golang.org/x/tools) que realiza análisis de inalcanzabilidad de todo el programa. Informa funciones y métodos que nunca pueden ser llamados desde ningún punto de entrada de tu programa. No es solo un linter: realiza análisis real de flujo de control y de punteros para determinar la alcanzabilidad.

Cómo encontrar código muerto escrito por IA

Ejecuta esto desde la raíz de tu módulo:

go run golang.org/x/tools/cmd/deadcode@latest ./...

Eso escanea todo tu módulo e imprime una lista de funciones inalcanzables, por ejemplo:

deadcode: unreachable: main/helpers.go:23:7:func helperNeverCalled()

También puedes pasar paquetes específicos o banderas:

• -test: incluir archivos de prueba en el análisis
• -filter: solo informar funciones que coincidan con una expresión regular (por ejemplo, -filter '_dead')
• -json: salida en JSON para integración con herramientas de CI

Por qué tu agente de IA deja código muerto

Los agentes LLM generan código probabilísticamente: a menudo escriben funciones de utilidad que nunca llaman, o respaldan una refactorización con una copia del código antiguo. Como el código compila y las pruebas pasan, es fácil pasarlo por alto. deadcode lo detecta de manera determinista.

Eliminar código muerto de forma segura

Después de ejecutar deadcode, revisa cada función inalcanzable manualmente. Una función puede ser inalcanzable porque se usa a través de reflexión, se invoca desde go:linkname, o es parte de una API pública: la herramienta tiene una bandera -reflect para tener en cuenta la reflexión. Pero en la mayoría de los casos, si no se llama desde main (o pruebas), puedes eliminarla con seguridad.

Luego ejecuta go test ./... para confirmar que nada se rompió. La eliminación de código muerto es una de las victorias más fáciles para la higiene del código base, y hace que la salida de tu agente sea más limpia para la próxima iteración.