Respuesta.

Historia de la pregunta:

En Rust, el sistema de módulos controla estrictamente la jerarquía y las dependencias entre archivos y módulos. A medida que el proyecto crece, a menudo surge la tarea de organizar dependencias complejas entre partes del código (por ejemplo, si los tipos de un módulo son necesarios en otro). En otros lenguajes (como C/C++), tal situación puede llevar a dependencias cíclicas, conflictos ocultos y errores en tiempo de compilación.

Problema:

En Rust no se pueden crear dependencias cíclicas directas (cada módulo puede referirse solo hacia arriba o hacia abajo en la jerarquía). Por lo tanto, si, por ejemplo, el tipo A del módulo mod_a utiliza el tipo B de mod_b, y mod_b quiere utilizar el tipo A, se presenta una situación de bloqueo. Una mala organización puede llevar a la imposibilidad de descomponer el proyecto en componentes independientes o a la duplicación de código.

Solución:

Rust recomienda introducir tipos y traits comunes en módulos o crates separados, y utilizar referencias externas (rutas completamente calificadas) entre ellos. A veces, ayuda trasladar interfaces (trait) a un eslabón intermedio separado. Así, las dependencias se vuelven direccionales y son más fáciles de analizar en el momento de la compilación.

Ejemplo de código:

// src/common.rs
pub trait Drawable { fn draw(&self); }

// src/shapes/mod.rs
use crate::common::Drawable;
pub struct Circle { pub r: f64 }
impl Drawable for Circle { fn draw(&self) { /* ... */ } }

// src/scene.rs
use crate::common::Drawable;
pub struct Scene<T: Drawable> { pub items: Vec<T> }

Características clave:

Extracción de un tipo o trait común por encima de los módulos dependientes
Traslado de tipos dependientes a un crate separado, si es necesario
Uso de rutas completamente calificadas

Preguntas capciosas.

¿Se puede usar pub use para evitar dependencias cíclicas e importar un módulo desde sí mismo?

No, pub use no es una solución para dependencias cíclicas: solo funciona para reexportar un elemento ya definido. Si se intenta pub use-ing un módulo que aún no ha sido compilado o declarado, habrá un error de compilación.

¿Por qué es inaceptable la declaración anticipada de módulos, como en C/C++?

En Rust no existe el mecanismo de declaración anticipada de tipos o módulos: todos los módulos, tipos y constantes deben ser declarados y definidos en el momento de la compilación. Esto permite que el compilador verifique completamente la jerarquía de tipos y evite conflictos inesperados. La declaración anticipada debilitaría las garantías de integridad del sistema de tipos.

¿Se pueden implementar referencias mutuas entre estructuras de dos módulos a través de Box o Rc?

Sí, si los tipos están acordados en sus dependencias (por ejemplo, a través de traits o un enum común), se pueden usar referencias indirectas (Box, Rc, Arc) entre estructuras. Sin embargo, esto no elimina la necesidad de declararlas en ámbitos que no crean módulos realmente cíclicos.

Errores típicos y anti-patrones

Duplicación múltiple de trait o tipo en diferentes módulos
Intentos de referirse al módulo padre desde el hijo directamente
Uso excesivo de pub use sin discusión de arquitectura
Creación de módulos grandes auxiliares que mezclan todo

Ejemplo de la vida real

Caso negativo

En el proyecto se crearon módulos separados shapes/mod.rs y render/mod.rs, pero ambos comienzan a usar tipos entre sí directamente. Surge un ciclo de dependencias, y el compilador genera un error de importación no resuelta.

Ventajas:

Descomposición por bloques semánticos

Desventajas:

Imposible compilar el proyecto
Arquitectura mal mantenida

Caso positivo

Se extrajeron tipos comunes en el módulo common, se trasladaron los traits también, y las dependencias se volvieron unidireccionales (scene depende de shapes, y shapes y scene dependen de common).