AD

¿Ya dominas lo básico? Un curso estructurado de Go es la vía rápida para dar el salto.

Ver cursos de Go en Udemy

Enlace de afiliado. No te cuesta nada extra.

🐹Lecciones de Go
Lección 17 / 68

Escribir comentarios

En esta lección dejarás notas en el código para quien lo lea después.

Go admite // para una línea y /* ... */ para varias. Un comentario escrito justo encima de una declaración se convierte en su documentación.

El código de ejemplo muestra las dos formas junto a código real.

La convención es muy concreta: el comentario de documentación empieza por el nombre de lo que documenta. Se escribe // Sumar devuelve la suma de a y b., no «Esta función suma…». La herramienta go doc y el sitio pkg.go.dev leen ese texto tal cual.

Sobre qué escribir: un comentario que repite lo que dice la línea sobra y envejece mal. El valioso explica por qué — qué alternativa se descartó, qué requisito obligó a esa solución. Eso es lo que no se deduce leyendo el código.

📖 Código de referencia
✍️ Tu código
Escribe tu código y pulsa «Ejecutar»

🧪 Este sitio no puede compilar ni ejecutar Go directamente, así que comprueba al instante si lo que escribiste coincide con el código de referencia (la corrección ocurre por completo en tu navegador; no se envía nada a ningún servidor).

🔗 El mismo tema en otros lenguajes

Mira cómo se escribe lo mismo en otro lenguaje.

Espacio publicitario (banner)
Espacio publicitario (en el artículo)