Linker e Simboli C++

/usr/bin/ld: undefined reference to `libA_func` (circular dependency between libA.a and libB.a) – C CIRCULAR_LIB_DEPENDENCY

CIRCULAR_LIB_DEPENDENCY

Il linker ld analizza le librerie statiche in un singolo passaggio sequenziale da sinistra a destra; se 'libA.a' dipende da 'libB.a' e viceversa, i simboli non vengono risolti a meno di ripetere le librerie o racchiuderle tra '-Wl,--start-group' e '-Wl,--end-group'.

Categoria: CGruppo: Linker e Simboli C++Confidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

Il linker ld analizza le librerie statiche in un singolo passaggio sequenziale da sinistra a destra; se 'libA.a' dipende da 'libB.a' e viceversa, i simboli non vengono risolti a meno di ripetere le librerie o racchiuderle tra '-Wl,--start-group' e '-Wl,--end-group'.

Messaggio originale

/usr/bin/ld: undefined reference to `libA_func` (circular dependency between libA.a and libB.a)

Contesto e parole chiave

Alias

  • circular dependency static library ld C++

Messaggi alternativi

  • dipendenza circolare tra librerie statiche nel linking

Prodotti

  • C++ Compiler (GCC g++ / Clang++ / MSVC)

Piattaforme

  • Linux
  • macOS
  • Windows

Parole chiave

  • c-plus-plus
  • CIRCULAR_LIB_DEPENDENCY
  • clang++
  • cpp
  • cpp.linker.circular-static-library-dependencies
  • errore-cpp-circular-static-library-dependency
  • g++
  • Linker e Simboli C++

Cause possibili

Origine del problema per Errore C++ Linker: Dipendenza Circolare tra Librerie Statiche (.a)

Il linker ld analizza le librerie statiche in un singolo passaggio sequenziale da sinistra a destra; se 'libA.a' dipende da 'libB.a' e viceversa, i simboli non vengono risolti a meno di ripetere le librerie o racchiuderle tra '-Wl,--start-group' e '-Wl,--end-group'.

molto comune

Diagnosi

Diagnostica di compilazione e memoria per Errore C++ Linker: Dipendenza Circolare tra Librerie Statiche (.a)

Compilare con lo standard appropriato (-std=c++20 o c++23) e attivare gli Address e Undefined Behavior Sanitizer.

Come leggere il risultato. Identifica errori di metaprogrammazione, violazioni di memoria o eccezioni non gestite.

terminal
g++ -std=c++20 -Wall -Wextra -fsanitize=address,undefined -g main.cpp -o app

Risoluzione

Risoluzione per Errore C++ Linker: Dipendenza Circolare tra Librerie Statiche (.a)

Difficoltà: mediaRischio: basso

Applicare la correzione al codice C++ secondo gli idiomi moderni (RAII, smart pointer, concetti).

  1. Ispezionare la riga segnalata dal compilatore o lo stack trace di std::terminate
  2. Risolvere l'ambiguità nei template, firme di funzioni o gestione dei lock
  3. Ricompilare ed eseguire i test unitari con ThreadSanitizer / Valgrind
terminal
g++ -std=c++20 -Wall -Wextra main.cpp -o app

Domande frequenti

Come risolvere l'errore Errore C++ Linker: Dipendenza Circolare tra Librerie Statiche (.a) in C++?

Il linker ld analizza le librerie statiche in un singolo passaggio sequenziale da sinistra a destra; se 'libA.a' dipende da 'libB.a' e viceversa, i simboli non vengono risolti a meno di ripetere le librerie o racchiuderle tra '-Wl,--start-group' e '-Wl,--end-group'.

Approfondimenti

Schede correlate