Regla
Evite demasiado grandes demasiado grandes.
Los archivos archivos con múltiples responsabilidades
son difíciles de de mantener.
Idiomas admitidos: 45+Introducción
Los archivos que abarcan miles de líneas suelen abordar múltiples preocupaciones no relacionadas, lo que dificulta la localización de funcionalidades específicas. Un archivo de 3000 líneas utils.js un archivo que contiene utilidades de validación, formato de cadenas, manipulación de fechas y utilidades de API obliga a los desarrolladores a desplazarse por código no relacionado para encontrar lo que necesitan. Los archivos grandes también generan conflictos de fusión cuando varios desarrolladores modifican diferentes secciones simultáneamente.
Por qué es importante
Mantenibilidad del código: Los archivos grandes mezclan funcionalidades no relacionadas, lo que requiere que los desarrolladores entiendan cientos de líneas de código irrelevante para modificar una función. Encontrar una lógica específica se convierte en un ejercicio de búsqueda en lugar de navegar a un archivo con un nombre apropiado.
Conflictos de control de versiones: Cuando varios desarrolladores trabajan en diferentes funcionalidades en el mismo archivo grande, los conflictos de fusión ocurren con frecuencia. Los archivos más pequeños y enfocados permiten el desarrollo paralelo, ya que cada desarrollador trabaja en archivos separados.
Eficiencia en la revisión de código: Revisar cambios en archivos grandes requiere más contexto. Los revisores deben entender cómo las modificaciones afectan a otro código no relacionado en el mismo archivo. Los archivos más pequeños hacen que el alcance de los cambios sea obvio, acelerando las revisiones.
Ejemplos de código
❌ No conforme:
// utils.js (1500+ líneas)
función validateEmail(correo electrónico) { /* ... */ }
función validarPhone(teléfono) { /* ... */ }
función formatDivisa(importe) { /* ... */ }
función formatDate(fecha) { /* ... */ }
función parseJSON(str) { /* ... */ }
función apiRequest(url) { /* ... */ }
función debounce(fn, retardo) { /* ... */ }
función acelerador(fn, límite) { /* ... */ }
// ... Más de 100 funciones no relacionadas
Por qué es incorrecto: Un archivo masivo contiene utilidades de validación, formato, análisis, llamadas a API y rendimiento. Hallazgo debounce() Requiere desplazarse por cientos de funciones no relacionadas. Múltiples equipos que modifican este archivo crean conflictos de fusión constantes.
✅ Conforme:
// validation/email.js
exportar función validateEmail(correo electrónico) { /* ... */ }
// validation/phone.js
exportar function validatePhone(teléfono) { /* ... */ }
// formato/moneda.js
exportar function formatearDivisa(importe) { /* ... */ }
// formato/fecha.js
exportar function formatDate(fecha) { /* ... */ }
// api/request.js
exportar function apiRequest(url) { /* ... */ }
// rendimiento/debounce.js
exportar función debounce(fn, retardo) { /* ... */ }
¿Por qué esto importa? Cada función de utilidad en un archivo dedicado dentro de directorios categorizados. Encontrar debounce() significa navegar a performance/debounce.js directamente. Los equipos que trabajan en diferentes utilidades no entran en conflicto porque están en archivos separados.
Conclusión
Mantén los archivos por debajo de 500 líneas siempre que sea posible. Cuando los archivos superen este límite, busca responsabilidades distintas que puedan extraerse en módulos separados. Organiza los archivos relacionados en directorios para mantener la estructura, a la vez que mantienes los archivos individuales enfocados y mantenibles.
