Bases de datos de compilación: reproducir la unidad de traducción que falla antes de cambiar cabeceras

Qué es

Con un generador compatible, CMAKE_EXPORT_COMPILE_COMMANDS de CMake produce compile_commands.json, que contiene las invocaciones del compilador para las unidades de traducción. La documentación limita esta funcionalidad a los generadores Makefile y Ninja, y señala dificultades con las compilaciones unitarias (unity builds). La base de datos describe comandos de compilación; no es una afirmación de que toda la aplicación se haya enlazado o ejecutado. Base de datos de compilación de CMake

Por qué importa

Un agente puede convertir un archivo correcto en incorrecto si responde a diagnósticos producidos con una ruta de inclusión, un modo de lenguaje o un conjunto de macros incorrectos. Antes de añadir ramas de compatibilidad, se debe comparar el contexto del diagnóstico con el comando usado por la compilación. Este método propuesto trata el contexto del compilador como evidencia.

Cómo aplicarlo

• Identificar el archivo fuente concreto y la configuración de compilación activa. Localizar su entrada en la base de datos de compilación y leer su directorio de trabajo y los argumentos del compilador.
• Regenerar la base de datos mediante la configuración normal de CMake del proyecto después de cambiar de toolchain u opciones relevantes. Evitar editar a mano el archivo generado como solución duradera.
• Reproducir el diagnóstico de la unidad de traducción a partir del directorio registrado en un entorno de compilación desechable. Preservar los límites de los argumentos al manejar rutas con espacios.
• Comparar la configuración del editor con ese comando: los directorios de inclusión, las cabeceras generadas, el estándar del lenguaje y las definiciones son buenos primeros candidatos. Registrar cualquier diferencia deliberada en lugar de suponer que ambas herramientas usan los mismos valores predeterminados.
• Tras corregir el contexto, volver a ejecutar la comprobación concreta y la compilación real del proyecto. Si el diagnóstico persiste, reducir el problema del código fuente conservando los mismos indicadores relevantes.

Trampas

Una cabecera puede estar incluida por varias unidades de traducción con macros distintas; un único comando inferido no puede representar todos los usos. Varias entradas para un mismo archivo también obligan a elegir la configuración prevista. Las compilaciones unitarias pueden combinar archivos fuente de formas que una herramienta por archivo no modela. No se debe describir un panel del editor sin errores como una compilación exitosa, ni una base de datos de compilación como un lockfile de dependencias completo.