Programación

Sintaxis de Java: leer el código y corregir sus errores

Llaves, nombres, punto y coma y convenciones, con un programa completo y un taller para reconocer fallos del compilador.

Referencias visuales: Java · Composición editorial.

Un punto y coma olvidado o una llave fuera de sitio pueden impedir que Java compile. Reconocer nombres, signos y bloques te ayuda a localizar el error y distinguir una regla del lenguaje de una preferencia de estilo.

Sintaxis y convención

La sintaxis determina qué código acepta el lenguaje. Una convención es un acuerdo de escritura que facilita leerlo. Una instrucción sin el punto y coma necesario puede impedir compilar. Una variable con un nombre poco claro puede compilar y seguir siendo difícil de entender.

Regla del lenguaje o acuerdo del proyecto
EjemploTipoEfecto
Terminar int edad = 25; con ;SintaxisPermite completar la declaración.
Usar edad y luego EdadIdentificadores distintosNo se refieren automáticamente a la misma variable.
Nombrar una clase HolaMundoConvenciónAyuda a reconocer una clase.
Indentar cuatro espaciosConvención del proyectoHace visibles los bloques.

Un programa completo

Java · HolaMundo.java

public class HolaMundo {
    public static void main(String[] args) {
        String nombre = "Ana";
        System.out.println("Hola, " + nombre);
    }
}
Texto · Salida esperada

Hola, Ana

Guarda el archivo como HolaMundo.java, compílalo con javac HolaMundo.java y ejecútalo con java HolaMundo. La clase pública y el archivo comparten el nombre. Los fragmentos de las secciones siguientes irían dentro de main, salvo que se indique otra cosa.

1class HolaMundo declara la clase.
2main es la entrada de esta forma clásica de programa.
3Las llaves delimitan la clase y el método.
4println muestra una línea en la consola.
Cada pieza tiene una función. No necesitas memorizar toda la firma el primer día.
La firma clásica de main
ParteQué significa aquí
publicEl método es accesible públicamente.
staticSe invoca sin crear una instancia de la clase.
voidNo devuelve un valor.
String[] argsRecibe los argumentos de texto de la ejecución.

Punto y coma, llaves y paréntesis

Un punto y coma termina declaraciones e instrucciones como la llamada a println. Las llaves agrupan el cuerpo de una clase, un método o un bloque. Los paréntesis delimitan argumentos de una llamada y condiciones. Cada apertura debe tener su cierre correspondiente.

Java · Un bloque y una condición

int edad = 20;
if (edad >= 18) {
    System.out.println("Mayor de edad");
}
Texto · Salida esperada

Mayor de edad

No pongas un punto y coma por costumbre después de if (edad >= 18). Eso terminaría una instrucción vacía y dejaría el bloque siguiente fuera de esa condición. El código puede compilar y ejecutar algo distinto de lo esperado.

Nombres e identificadores

Un identificador no contiene espacios ni comienza por un dígito. No puedes usar una palabra reservada como class para nombrar una variable. Evita _ como nombre: en Java moderno tiene usos especiales para elementos sin nombre y no sirve para declarar una variable que luego puedas consultar como _. Elige nombres que expliquen el dato o la acción.

Convenciones habituales
ElementoForma habitualEjemplo
ClasePascalCaseCuentaUsuario
MétodocamelCasecalcularTotal
VariablecamelCasenumeroIntentos
ConstanteMAYUSCULAS_CON_GUIONESMAX_INTENTOS
PaqueteMinúsculases.ejemplo.curso

Sigue las convenciones del proyecto si son diferentes. No cambies un identificador externo o una clase existente solo para adaptar su aspecto a esta tabla.

Tres errores que puedes reconocer

Java · Antes

int edad = 25
Java · Después

int edad = 25;
Falta el final de la instrucción. Añade el punto y coma.
Java · Antes

System.out.Println("Hola");
Java · Después

System.out.println("Hola");
La llamada distingue mayúsculas y minúsculas.
Java · Antes

if (true) {
    System.out.println("Hola");
Java · Después

if (true) {
    System.out.println("Hola");
}
Los bloques deben cerrar sus llaves.

Comentarios que ayudan

Tres clases de comentario
FormaUsoEjemplo
//Nota hasta el final de la línea// Evita repetir el envío
/* ... */Nota en varias líneas/* Explicación del motivo */
/** ... */Documentación JavadocDocumentar una clase o un método.

Un comentario sirve para explicar una decisión o una restricción que el código no cuenta. total = a + b; // Suma a y b repite lo que ya ves. Si la regla cambia, revisa también el comentario. Los comentarios de bloque no se anidan.

Taller: arregla tres fallos antes de ejecutar

Guarda este fragmento como Saludo.java. Hay tres fallos: dos de sintaxis o nombres y uno que impide cerrar la estructura. Localízalos antes de abrir la solución.

Java · Saludo.java con errores deliberados

public class Saludo {
    public static void main(String[] args) {
        String nombre = "Ana"
        System.out.Println("Hola, " + nombre);
}
Solución y motivo de cada corrección
Java · Saludo.java corregido

public class Saludo {
    public static void main(String[] args) {
        String nombre = "Ana";
        System.out.println("Hola, " + nombre);
    }
}

Faltaba el punto y coma de la declaración; el método se escribe println con p minúscula; faltaba una llave para cerrar uno de los dos bloques. La salida es Hola, Ana.

El compilador puede señalar varias consecuencias del primer error. Corrige uno, vuelve a compilar y comprueba qué diagnósticos desaparecen.

Antes de pasar a variables

Debes poder identificar clase, método, instrucciones y bloques. El formato del editor ayuda a verlos, pero no añade por sí solo una regla que falta. En la siguiente lección elegirás tipos para guardar información.

Para seguir leyendo

Volver a UnaCosa