Comentarios en PSeInt: Sintaxis // (2026)
Un buen programa no solo funciona: también se entiende. Los comentarios son notas que escribes dentro del código para explicar qué hace cada parte, y que PSeInt ignora al ejecutar el programa. En PSeInt los comentarios se escriben con doble barra (//): todo lo que sigue a // en una línea es un comentario. En esta guía verás la sintaxis exacta y cómo usarlos para documentar tus algoritmos.
Sintaxis
// Esto es un comentario de línea completa
x <- 5 // Esto es un comentario al final de una instrucción
// Para comentar varias líneas,
// se repite // al inicio de cada una
La doble barra puede ir al inicio de una línea (toda la línea es comentario) o después de una instrucción (solo el final de la línea es comentario). PSeInt no ejecuta nada de lo que esté comentado.
Explicación
//comenta hasta el fin de la línea. Todo lo que escribas después de la doble barra en esa línea es ignorado por PSeInt. Es la única sintaxis de comentario: siempre es por línea.- Dos posiciones habituales. Puedes usar una línea completa para explicar un bloque (
// Calcula el promedio de las notas) o un comentario corto al final de una instrucción (suma <- 0 // inicializa el acumulador). - Para varias líneas, repite
//. No existe un comentario de bloque que abarque varios párrafos: cada línea que quieras comentar debe empezar con su propia doble barra. - No afectan la ejecución. Puedes agregar, quitar o modificar comentarios sin que el programa cambie su comportamiento. Son solo para las personas que leen el código: tú en el futuro, tu profesor o tus compañeros.
- Úsalos para explicar el «por qué». Un buen comentario no repite lo obvio (
// suma a y bjunto asuma <- a + baporta poco); explica la intención (// acumula para calcular el promedio al final). - También sirven para desactivar código. Si quieres probar el programa sin una línea, la comentas con
//en lugar de borrarla; así la recuperas fácilmente cuando la necesites.
Ejemplo completo
Este programa calcula el promedio de 3 notas usando comentarios explicativos en los puntos clave:
Algoritmo Promedio_Con_Comentarios
// Declaración de variables: 3 notas y el promedio
Definir n1, n2, n3, promedio Como Real
// Entrada de datos: se piden las 3 notas al usuario
Escribir "Ingresa la primera nota:"
Leer n1
Escribir "Ingresa la segunda nota:"
Leer n2
Escribir "Ingresa la tercera nota:"
Leer n3
// Proceso: se calcula el promedio de las 3 notas
promedio <- (n1 + n2 + n3) / 3
// Salida: se muestra el resultado
Escribir "El promedio es: ", promedio
FinAlgoritmo
Observa cómo los comentarios dividen el programa en sus tres etapas clásicas —entrada, proceso y salida— y cada etapa queda claramente identificada. Si dentro de seis meses vuelves a este código, entenderás su estructura de un vistazo.
Errores comunes
- Usar otra sintaxis de comentario. Ni
#, ni/* */, ni<!-- -->son comentarios en PSeInt. Solo la doble barra//funciona. - Comentar código y olvidar que sigue comentado. Si desactivaste una línea con
//para una prueba, recuerda quitar las barras cuando quieras que vuelva a ejecutarse. - Comentar en exceso lo obvio. Llenar cada línea de comentarios que repiten el código (
// lee njunto aLeer n) dificulta la lectura en lugar de ayudar. Comenta los bloques y las decisiones importantes.
Ver también
- Sintaxis de PSeInt: guía completa
- ¿Qué es PSeInt?
- Ejercicios resueltos de PSeInt
- SubProceso en PSeInt: sintaxis y Por Referencia
- Dimension en PSeInt: arreglos sintaxis
- Punto y coma en PSeInt: ¿obligatorio u opcional?
Preguntas frecuentes
