Gå til innhold

Lese kompilatorfeil

Den raskeste måten å bli bedre i C++ på er å lære å lese feilmeldinger. Nybegynnere stivner foran veggen av rød tekst; erfarne programmerere skummer gjennom den, finner linjen og fikser problemet på sekunder. Forskjellen er ikke intelligens; det er å vite hva man skal se etter.

Denne siden er en veiledning i å lese typisk C++-kompilatorutskrift, de vanligste feilene du kommer til å treffe på, og hva du skal gjøre med hver av dem.

Anatomien til en feilmelding

En typisk kompilatorfeil har denne formen:

main.cpp:14:18: error: expected ';' after expression
    std::cout << "Hello"
                ^
                ;

Tre deler du alltid vil finne:

Del Hva den forteller deg
main.cpp:14:18 Filen, linjenummeret og kolonnen der kompilatoren ble forvirret
error: expected ';'... Hva kompilatoren mener er galt
^-linjen (caret) En visuell peker til stedet i kildekoden

Start alltid med fil:linje. Åpne den filen, hopp til den linjen, og les koden rundt.

Lese utskrift med flere feil

Én enkelt feil gir ofte flere feilmeldinger, fordi når kompilatoren først er forvirret, holder den seg forvirret en stund. Fiks alltid den første feilen først, og bygg på nytt. Mange av de senere feilene forsvinner av seg selv.

Et vanlig mønster:

main.cpp:14:18: error: expected ';' after expression
main.cpp:15:5:  error: use of undeclared identifier 'std'
main.cpp:15:23: error: expected ';' after expression
main.cpp:18:1:  error: extraneous closing brace ('}')

Fire feil, én tabbe: et manglende semikolon på linje 14 som forplanter seg til forvirring om alt etterpå. Fiks det semikolonet og bygg på nytt før du gjør noe annet.

De vanlige feilene og hva de egentlig betyr

expected ';' after ...

Du glemte et semikolon. Feilen peker som regel på linjen etter den manglende, fordi kompilatoren ikke skjønte at den forrige setningen var slutt før den så noe som ikke kunne være en fortsettelse.

std::cout << "Hello"        // missing semicolon here
std::cout << "World";       // error reported here

use of undeclared identifier 'foo'

Du brukte et navn kompilatoren ikke kjenner til. Tre vanlige årsaker:

  1. Skrivefeil. std:cout i stedet for std::cout. cout i stedet for std::cout.
  2. Manglende #include. Du brukte std::vector men #include-et ikke <vector>.
  3. Variabel deklarert i et annet virkeområde. Du deklarerte x inni en indre blokk og prøvde å bruke den utenfor.

no matching function for call to 'foo(...)'

Du kalte en funksjon, men argumentene passer ikke til noen versjon av den. Kompilatoren lister vanligvis kandidatene den vurderte:

error: no matching function for call to 'add(int, std::string)'
note: candidate function not viable: no known conversion
      from 'std::string' to 'int' for 2nd argument
      int add(int a, int b);

Løsningen ligger i note: candidate ...-linjen: les den for hva kompilatoren forventet og sammenlign med det du sendte inn.

expected '}' at end of input

En { et sted har ikke en tilhørende }. Linjenummeret er ofte helt på slutten av filen, noe som ikke er særlig nyttig. Gå tilbake gjennom filen og let etter en åpningsparentes uten en lukkende. Editorens parentesmatching er vennen din.

redefinition of '...'

Du definerte det samme to ganger. Vanlige årsaker:

  1. To .cpp-filer som implementerer den samme funksjonen.
  2. En header inkludert fra to steder, uten #pragma once eller en header guard.
  3. Å definere en funksjon i en header uten å merke den inline (den blir kompilert inn i hver fil som inkluderer headeren).

'X' was not declared in this scope

Det samme som "use of undeclared identifier", en annen kompilators formulering av det samme problemet.

cannot convert 'X' to 'Y'

Typemismatch. Du tilordnet, returnerte eller sendte noe av én type der en annen forventes. Les typene nøye:

error: cannot convert 'std::string' to 'int' in assignment

Du prøvde å legge en string inn i en int-variabel. Sjekk typene på begge sider.

member access into incomplete type 'X'

Du brukte someObject.field eller somePtr->field på en type som bare har blitt forhåndsdeklarert (forward-declared), ikke fullt definert. Enten inkluder headeren som definerer typen, eller flytt tilgangen til et sted der den fulle typen er synlig.

expression is not assignable

Du prøvde å skrive til noe som ikke kan skrives til: en const-variabel, resultatet av et funksjonskall, eller en midlertidig verdi.

const int x = 5;
x = 10;                     // expression is not assignable

if (x = 5) { }              // also a warning, see below

Linkerfeil: undefined reference to ...

Forskjellig fra kompileringsfeil: disse kommer fra linkeren, neste trinn i byggingen. Kompilatoren godtok koden din, men da det ble tid for å sette sammen det endelige programmet, fant den ikke implementasjonen av noe:

undefined reference to `Motor::start()'

Vanlige årsaker:

  1. Du deklarerte en funksjon, men definerte den aldri (deklarasjon i en header, ingen implementasjon i noen .cpp).
  2. .cpp-filen som inneholder implementasjonen er ikke med i CMakeLists.txt.
  3. Du glemte å linke mot et bibliotek (target_link_libraries mangler).

Linkerfeil inneholder ikke linjenummer i kildekoden din; de viser til symboler.

Advarsler

Advarsler er ikke feil; byggingen lykkes. Men advarsler indikerer nesten alltid en ekte feil eller en kodelukt:

warning: control reaches end of non-void function
warning: comparison of integer expressions of different signedness
warning: '=' used in a context where '==' was probably intended

Behandle advarsler som feil. De fleste kompilatorer godtar et flagg (-Wall -Wextra -Werror for GCC og Clang) som forfremmer dem — se hvordan du slår dem på. Når koden din kompilerer uten advarsler, fanger du opp en klasse feil som ellers ville overlevd helt til kjøretid.

Når meldingen fortsatt ikke gir mening

Fire strategier, i denne rekkefølgen:

1. Les linjen over den feilen peker på. Mange feil (særlig feil om manglende semikolon) er egentlig én linje tidligere enn der kompilatoren klager.

2. Kommenter ut den problematiske linjen og bygg på nytt. Hvis resten av filen så kompilerer rent, har du snevret inn problemet.

3. Søk etter den eksakte feilteksten. Kopier den mest spesifikke delen, vanligvis fra error:, og lim den inn i en søkemotor. De fleste feilmeldinger har blitt spurt om på Stack Overflow flere ganger.

4. Be en KI om å oversette meldingen. Å lime inn hele kompilatorutskriften sammen med den problematiske koden i en KI-assistent er et av dens beste bruksområder. Se Bruke KI til koding for vanene som hindrer at dette blir til "KI-en gjør jobben min".

Malfeil er et spesialtilfelle: de kan være hundrevis av linjer lange for én enkelt skrivefeil. Trikset er å lese ovenfra og ned og se etter linjen note: candidate template ignored: ..., som sier hvorfor en mal ikke kunne brukes. Den merknaden inneholder som regel det egentlige problemet på rent norsk.

Et gjennomarbeidet eksempel

Du kompilerer dette:

#include <iostream>

int main() {
    int x = 5
    std::cout << x << "\n";
    return 0;
}

Og får:

main.cpp:5:5: error: use of undeclared identifier 'std'
    std::cout << x << "\n";
    ^
main.cpp:4:13: error: expected ';' after expression
    int x = 5
            ^
            ;

To feil. Den første sier at linje 5 har en "undeclared identifier std", noe som er tøv fordi std er deklarert av #include-en. Det er avsløringen: kompilatoren er så forvirret at åpenbare ting har sluttet å gi mening. Se alltid på den første feilen først. Den andre meldingen peker på linje 4, som mangler semikolonet sitt. Legg til semikolonet, kompiler på nytt, og begge feilene forsvinner.

Når du har gjort dette fem eller seks ganger, begynner du å fikse manglende semikolon før kompilatoren engang er ferdig med å klage på dem.

Kompilatorfeil handler om kode som ikke vil bygge. Når den bygger, men gjør feil ting når du kjører den, er verktøyet du vil ha debuggeren.