¿Qué dificulta la lectura del código de otras personas?

Answer 1

Demasiada POO que se convierte en POO.

¡He visto un código que no crea más de 4 objetos intermediarios para una llamada!

Otro es el mal manejo de errores. El manejo de errores se realiza en todas partes y se entrelaza con la lógica empresarial. Las mismas condiciones de error se verifican muchas veces y de manera diferente.

Estilo de código incorrecto o mezcla de varios estilos.

Globales o similares (ej. Singletons con estado)

Mal nombre y sobre compacidad. (Ej. Uso de operador ternario con asignaciones dentro. O tener un método “validar” que persista en los datos)

Nombres genéricos como “* Procesador”, “* Manejador”, “* Administrador” …

Dependencias de extracción: uso del localizador de servicios en varios lugares.

Uso incorrecto de OOP: sobrecargar un método para hacer otra cosa.

¡Eso es más o menos lo que veo todos los días!

Answer 2

Para mí, el impedimento número uno es la falta de comentarios. Si no sé qué pretende hacer el programa (que es parte del propósito de los comentarios), tengo que leerlo con mucho cuidado e intentar averiguar qué hace realmente. Por supuesto, es posible que tenga que hacer eso de todos modos si estoy tratando de averiguar si funciona correctamente o corregir un error. Pero si hace algo extraño, como trabajar solo si el número de caracteres en una cadena es par, ¿quiso el autor hacer eso? Y si eso fue deliberado, ¿cómo se supone que alguien más que usa esa función sabe que solo debería llamarse con una cadena de longitud par?

Piense en las funciones estándar de C strncpy () y strncat (), y cómo manejan una cadena de entrada que es demasiado larga. Si no tuviera la página de manual y la descripción en numerosos libros, ¿sabría realmente cómo se supone que funcionan simplemente leyendo el código? ¿Y estaría tentado de “arreglarlos”?

Answer 3

No han leído ni internalizado los principios descritos en el libro Clean Code.

No han aprendido ningún patrón de diseño.

No saben lo suficiente sobre arquitectura de software.

No se adhieren a los principios SÓLIDOS.

Están mezclando niveles de abstracción.

Answer 4

Depende totalmente de qué tipo de estilo de escritura esté siguiendo la otra persona. Si él / ella sigue el mismo estilo que el suyo, entonces es fácil de leer; de lo contrario, le resultará difícil de leer, ya que tiene la costumbre de leer y escribir código en su propio estilo.

Es lo mismo que leer tu propia escritura y leer a otras personas que escriben, en realidad no entiendes algunas palabras de lo que la otra persona realmente ha escrito.

Answer 5

Si estás leyendo Minecraft, es la desofuscación. Además, los desarrolladores de Forge no lo comentaron. Necesita comentarios en su código o será ilegible para usted