...
Eroare C++ · Funcții, apeluri și linker

undefined reference to `main'

Pe scurt

Programul se compilează, dar linker-ul nu găsește funcția main, de unde pornește orice program C++. De obicei ai scris-o cu altă literă (Main, mian) sau ai uitat-o. Scrie exact int main() { ... }.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Orice program C++ executabil începe din funcția main, scrisă exact așa: litere mici, tip de întoarcere int. Compilatorul traduce fiecare funcție separat, iar la final linker-ul leagă totul și caută main ca punct de pornire. Dacă nu o găsește, raportează undefined reference to 'main'.

Mesajul arată diferit în funcție de platformă: pe Linux cu GCC apare de obicei cu /usr/bin/ld: ... in function '_start', pe macOS Undefined symbols for architecture arm64: "_main", iar în editorul nostru (WebAssembly) wasm-ld: error: undefined symbol. Nu are număr de linie, pentru că problema nu e într-un rând anume, ci în lipsa funcției.

Cauze tipice: Main, mian sau main1, fișierul cu main necompilat (într-un proiect cu mai multe fișiere) sau un main pus din greșeală într-un namespace sau într-o clasă.

De ce apare: cauzele frecvente

1main scris cu literă mare sau greșit

Greșit
C++
int Main() {
    cout << "Salut\n";
    return 0;
}
Corect
C++
int main() {
    cout << "Salut\n";
    return 0;
}

C++ face diferența între litere mari și mici; linker-ul caută exact main.

2main pus într-un namespace

Greșit
C++
namespace magazin {
    int main() { return 0; }
}
Corect
C++
namespace magazin {
    void porneste() {}
}
int main() { magazin::porneste(); return 0; }

main trebuie să fie o funcție globală, nu una dintr-un namespace sau o clasă.

3Fișierul cu main nu e compilat

Greșit
C++
clang++ produs.cpp -o magazin
Corect
C++
clang++ main.cpp produs.cpp -o magazin

Când ai mai multe fișiere, toate trebuie date compilatorului (sau adăugate în proiect).

Repară tu

Repară eroarea, direct în pagină

Programul afișează un mesaj de bun venit, dar la linkare apare eroarea că main nu există. Repară numele funcției ca programul să afișeze Bun venit in aplicatie!.

Codul care dă eroarea
C++
#include <iostream>
using namespace std;

int Main() {
    cout << "Bun venit in aplicatie!\n";
    return 0;
}
După reparație, programul afișează
Bun venit in aplicatie!
Indiciu

Punctul de pornire se numește exact main, cu litere mici.

Alte forme ale mesajului

  • /usr/bin/ld: /usr/lib/x86_64-linux-gnu/Scrt1.o: in function `_start': (.text+0x1b): undefined reference to `main'
  • Undefined symbols for architecture arm64: "_main", referenced from: <initial-undefines>
  • Undefined symbols for architecture x86_64: "_main", referenced from: implicit entry/start for main executable
  • wasm-ld: error: undefined symbol: main
  • error LNK2019: unresolved external symbol main referenced in function "int __cdecl invoke_main(void)"

Cum o eviți pe viitor

  • Începe fiecare program nou din același schelet: int main() { return 0; }.
  • Într-un proiect cu mai multe fișiere, ține main într-un fișier separat (de exemplu main.cpp) și verifică dacă e inclus în compilare.
  • Pentru biblioteci (cod fără main), compilează cu -c ca să obții doar fișiere obiect, fără linkare.

Întrebări frecvente

De ce eroarea nu arată nicio linie din codul meu?

Pentru că vine de la linker, după ce compilarea a reușit. Linker-ul nu caută o linie greșită, ci o funcție care lipsește din tot programul.

Pe Windows primesc unresolved external symbol WinMain. E același lucru?

E aceeași idee: linker-ul caută punctul de pornire. Proiectul e configurat ca aplicație grafică (care pornește din WinMain); pentru un program de consolă, alege tipul Console Application.

Erori înrudite

← Toate erorile C++

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață C++ de la zero, cu exerciții la fiecare lecție

Curs C++: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.