Erro exit status 1 no Arduino: como corrigir erros de compilação

O erro exit status 1 do Arduino é uma mensagem genérica que diz que o seu código não pôde ser compilado, ou seja, o compilador não conseguiu transformar o programa em código de máquina que o processador entende; a causa real nunca está nessa linha. A causa está na primeira linha que contém a palavra error:, algumas linhas acima no painel de saída: você digitou um nome errado, esqueceu um ponto e vírgula, uma biblioteca não está instalada ou o código foi escrito para outra placa. A notificação Compilation error: exit status 1 (Erro de compilação) no canto inferior direito do Arduino IDE 2 e a linha Error compiling for board Arduino Uno. na antiga versão 1.8 significam exatamente a mesma coisa.

Neste guia você vai ver primeiro como a compilação funciona nos bastidores e como ler uma mensagem de erro separando-a em arquivo, linha e coluna. Depois vamos passar um por um pelos erros de compilação mais comuns: was not declared in this scope, expected ';' before, No such file or directory, does not name a type, redefinition of e Sketch too big. Para cada um, você encontra a situação que o causa, a mensagem real que o compilador mostra e um exemplo corrigido que compila sem erros. Também incluímos os erros causados pela escolha da placa errada, problemas específicos do ESP32 e do Raspberry Pi Pico e, no fim, uma tabela de erros e soluções que junta tudo. Se o seu código compila bem, mas não vai para a placa, o problema está em outra etapa; para isso, veja o guia Arduino não carrega o código.

O que é exit status 1 no Arduino? Compilar vs carregar

Quando você aperta Verificar (o visto) ou Carregar, o Arduino IDE roda vários programas nos bastidores. Primeiro ele junta os arquivos .ino da pasta do sketch e os transforma em um arquivo C++ comum, acrescentando no topo o cabeçalho Arduino.h e os protótipos das suas funções. Depois, um compilador como o avr-g++ no Uno ou o xtensa-esp32-elf-g++ no ESP32 compila esse arquivo e as bibliotecas que você usa, o linker junta todas as partes em um só programa e, por fim, o IDE verifica se o programa cabe na placa. Todo programa retorna um código de saída quando termina: 0 significa sucesso e 1 significa falha. “exit status 1” diz exatamente isso: um dos programas da cadeia falhou. É por isso que a mesma frase também aparece quando o avrdude falha durante um carregamento; a mensagem antes dela diz qual dos dois é.

Como ler uma mensagem de erro do Arduino

Toda linha de erro do compilador segue o mesmo padrão: primeiro o nome do arquivo, depois os números da linha e da coluna separados por dois-pontos, seguidos do tipo de erro e da descrição. Logo acima costuma haver uma linha como In function 'void loop()':, que diz em qual função está o erro; abaixo, há uma cópia da linha com problema e um pequeno marcador ^ apontando para o problema. error é um erro de verdade que interrompe a compilação, warning é só um aviso e o código continua compilando, e note acrescenta informações à mensagem anterior. O compilador muitas vezes também dá uma sugestão: no exemplo abaixo, ele mesmo mostra a grafia correta com suggested alternative: 'digitalWrite'.

1. Em Arquivo > Preferências, marque compilação ao lado de Mostrar saída detalhada durante. Assim você também vê quais arquivos e quais pastas de bibliotecas o compilador usou.
2. A placa não precisa estar conectada: aperte o botão Verificar (o visto). Verificar só compila; se o erro está na etapa de compilação, apertar Carregar só faz perder tempo.
3. Role o painel de saída até o topo e encontre a primeira linha que contém error:. A maioria dos erros depois dela é efeito em cascata desse primeiro.
4. Vá até o número da linha da mensagem. O IDE 2 sublinha em vermelho o caractere com erro, enquanto a versão 1.8 pinta a linha inteira de vermelho. Se você não vê problema nessa linha, olhe a linha de cima.
5. Corrija só esse primeiro erro e aperte Verificar de novo. Se o número de erros cair de repente, você está no caminho certo.
6. Se for buscar na internet, tire da mensagem os nomes das suas variáveis e os caminhos de arquivos: buscar was not declared in this scope em vez de 'counter' was not declared in this scope traz muito mais resultados. Já quando for pedir ajuda em um fórum, copie a saída inteira.

O erro 'was not declared in this scope' e como corrigi-lo

Essa mensagem significa que o compilador não reconhece, naquele ponto, um nome que você usou. A causa mais comum é um erro de digitação: o Arduino diferencia maiúsculas de minúsculas, então digitalwrite, Digitalwrite e digitalWrite são três nomes diferentes. A segunda grande causa é o escopo: se você declara uma variável dentro do setup(), ela só existe enquanto o setup() roda e o loop() não a enxerga. Se você vai usar uma variável em mais de uma função, declare-a fora de todas as funções, no topo do arquivo. Declarar uma variável depois da linha em que você a usa dá o mesmo erro, porque o compilador lê o arquivo de cima para baixo. Por fim, esse erro também aparece quando você usa um objeto cuja biblioteca não incluiu (Wire, Servo) ou um recurso que a placa selecionada não tem (Serial1 no Uno).

1// Kapsam (scope) örneği / Scope example
2const int LED_PIN = 13;   // global: her fonksiyon görür / global: every function can see it
3int yanmaSayisi = 0;      // setup() içine taşırsan loop() göremez / move it into setup() and loop() can't see it
4
5void setup() {
6  pinMode(LED_PIN, OUTPUT);
7  Serial.begin(9600);
8}
9
10void loop() {
11  int sure = 500;                // yerel: yalnız loop() içinde / local: only inside loop()
12  digitalWrite(LED_PIN, HIGH);   // digitalwrite yazarsan: was not declared / typing digitalwrite: was not declared
13  delay(sure);
14  digitalWrite(LED_PIN, LOW);
15  delay(sure);
16  yanmaSayisi++;
17  Serial.println(yanmaSayisi);   // kaç kez yandı / how many times it blinked
18}

'expected ';' before' e outros erros de sintaxe

Em C++, todo comando termina com ponto e vírgula. Quando você esquece o ponto e vírgula no fim de uma linha, o compilador só percebe quando lê a próxima palavra. Por isso, com o compilador do Uno, o número da linha em expected ';' before 'delay' aponta para a linha abaixo do erro: o ponto e vírgula que falta está no fim da linha antes do delay. Os compiladores mais novos dos cores do ESP32 e do Pico apontam direto para o fim da linha em que falta o ponto e vírgula. Se você o esquecer na última linha de uma função, a mensagem vira expected ';' before '}' token. Os erros de chaves e parênteses se comportam de forma parecida. Se você esquecer de fechar a chave de um bloco if ou de uma função, o compilador lê até o fim do arquivo e só então diz expected '}' at end of input. Se a chave não fechada estiver dentro do setup(), você também recebe a function-definition is not allowed here before '{' token, porque, para o compilador, o loop() agora é uma função que você está tentando definir dentro do setup(). Usar vírgulas em vez de pontos e vírgulas dentro dos parênteses de um laço for é outro clássico dessa família.

'No such file or directory': biblioteca não encontrada

As linhas fatal error: DHT.h: No such file or directory e o compilation terminated. que vem em seguida dizem que o arquivo pedido por uma linha #include do seu código não foi encontrado no computador. A palavra “fatal” significa que a compilação parou por completo nesse ponto, então você não vai ver os erros do resto do código até corrigir este. A causa é quase sempre uma biblioteca não instalada. Quando abrir um projeto da internet, leia uma por uma as linhas #include do topo e instale a biblioteca de cada uma em Ferramentas > Gerenciar Bibliotecas. Se você não escolher Instalar tudo na janela que pergunta sobre as dependências, a biblioteca principal é instalada, mas a segunda biblioteca de que ela precisa continua faltando; nesse caso, o nome do arquivo na mensagem não é um que você escreveu, e sim um arquivo chamado de dentro da biblioteca (por exemplo, Adafruit_Sensor.h). Maiúsculas e minúsculas no nome do arquivo também importam: no Linux, dht.h e DHT.h são arquivos diferentes. Para os três jeitos de instalar uma biblioteca e os problemas com ZIP, veja o guia Como instalar uma biblioteca no Arduino.

O erro 'does not name a type'

does not name a type significa que o compilador esperava um tipo de dado (como int, float, Servo ou LiquidCrystal_I2C) no início de uma linha, mas não reconheceu a palavra que você escreveu. Há três causas comuns. A primeira é esquecer a linha #include da biblioteca: se Servo lid; for compilado sem o Servo.h, você recebe 'Servo' does not name a type. A segunda é escrever o tipo errado: o certo é String, não string, e int, não Int, e o compilador muitas vezes ajuda com did you mean 'String'?. A terceira, e a mais surpreendente, é escrever um comando fora de uma função. Fora das funções você só pode declarar coisas: int angle = 0; é válido, mas se você escrever angle = 90; sozinho em uma linha mais abaixo, o compilador toma angle por um nome de tipo e informa 'angle' does not name a type. Há mais uma armadilha específica do Arduino: o IDE acrescenta automaticamente os protótipos das suas funções logo antes da primeira função. Se você escreveu uma função que retorna um tipo struct seu e declarou a struct abaixo do setup(), o protótipo fica antes da struct e você recebe o mesmo erro. A solução é levar as definições de struct para o topo do arquivo, antes da primeira função.

1#include <Servo.h>   // bu satır yoksa: 'Servo' does not name a type / without it: 'Servo' does not name a type
2
3struct Olcum {       // struct'ı ilk fonksiyondan önce tanımla / define structs before the first function
4  int ham;
5  float volt;
6};
7
8Servo kapak;         // tür adı büyük harfle başlar / the type name starts with a capital letter
9int aci = 0;         // dışarıda tanım ve ilk değer serbest / declaring with a value outside is fine
10// aci = 90;         // dışarıda tek başına atama: 'aci' does not name a type / bare assignment outside: error
11
12Olcum potOku() {
13  Olcum o;
14  o.ham = analogRead(A0);           // potansiyometre A0'da / potentiometer on A0
15  o.volt = o.ham * 5.0 / 1023.0;    // 0-1023 değerini volta çevir / convert 0-1023 to volts
16  return o;
17}
18
19void setup() {
20  Serial.begin(9600);
21  kapak.attach(9);   // servo sinyali D9 / servo signal on D9
22}
23
24void loop() {
25  Olcum o = potOku();
26  aci = map(o.ham, 0, 1023, 0, 180);   // atama fonksiyonun içinde / assignment inside a function
27  kapak.write(aci);
28  Serial.println(o.volt);
29  delay(20);
30}

O erro 'redefinition of': definir a mesma coisa duas vezes

O erro redefinition of 'void setup()' diz que há duas definições com o mesmo nome; a linha note: 'void setup()' previously defined here, logo abaixo, mostra onde está a primeira. Para iniciantes, a causa mais comum é colar dois sketches de exemplo um depois do outro em um só arquivo: você acaba com duas funções setup() e duas loop(). A segunda causa são as abas. Antes de compilar, o Arduino IDE junta em um só todos os arquivos .ino da pasta do sketch. Um backup antigo que você copiou para a pasta (por exemplo, project_old.ino) ou uma segunda aba com seus próprios setup() e loop() causa esse erro mesmo que você nunca abra essa aba; a solução é tirar esse arquivo da pasta. Declarar a mesma variável duas vezes gera uma mensagem parecida: redefinition of 'int led'. O irmão desse erro no linker é o multiple definition of; ele aparece quando uma variável que recebe um valor em um arquivo de cabeçalho (.h) é incluída em dois arquivos .cpp separados. O oposto dele, undefined reference to, aponta para uma função cujo protótipo você escreveu, mas cujo corpo nunca escreveu, ou cujo nome você escreveu diferente.

1// İki örneği birleştirmek: tek setup(), tek loop() / Merging two sketches: one setup(), one loop()
2const int LED_PIN = 13;          // 1. örnek: Blink / sketch 1: Blink
3const int POT_PIN = A0;          // 2. örnek: potansiyometre / sketch 2: potentiometer
4unsigned long oncekiZaman = 0;   // millis() zamanlayıcısı / millis() timer
5bool ledDurum = false;
6
7void setup() {
8  pinMode(LED_PIN, OUTPUT);      // 1. örneğin setup içeriği / setup body of sketch 1
9  Serial.begin(9600);            // 2. örneğin setup içeriği / setup body of sketch 2
10}
11
12void loop() {
13  // 1. örnek: delay yerine millis ile yanıp sönme / sketch 1: blink with millis instead of delay
14  if (millis() - oncekiZaman >= 500) {
15    oncekiZaman = millis();
16    ledDurum = !ledDurum;
17    digitalWrite(LED_PIN, ledDurum);
18  }
19  // 2. örnek: potansiyometreyi oku ve yaz / sketch 2: read and print the potentiometer
20  int deger = analogRead(POT_PIN);   // 0-1023 arası / between 0 and 1023
21  Serial.println(deger);
22  delay(50);
23}

Siga esta ordem ao juntar: primeiro reúna no topo as linhas #include dos dois sketches, sem repetir, depois acrescente as variáveis globais e as constantes; se o mesmo nome existir nos dois, renomeie um deles. Em seguida, coloque o conteúdo dos dois setup() em um único setup() e o conteúdo dos dois loop() em um único loop(). Se um dos sketches usa um delay() longo, ele segura o outro; dá para resolver isso com a técnica de temporização millis() em vez de delay(). Por fim, confira se os dois sketches usam o mesmo pino: o compilador não vai perceber, mas o seu circuito não vai funcionar como esperado.

Erros 'Sketch too big' e de memória insuficiente

No fim de toda compilação bem-sucedida você vê duas linhas. Quando você compila o exemplo de escopo acima para o Uno, a linha O sketch usa 2212 bytes (6%) de espaço de armazenamento para programas. O máximo são 32256 bytes. (em inglês, Sketch uses ... of program storage space) diz quanto de memória flash o programa ocupa, e Variáveis globais usam 190 bytes (9%) de memória dinâmica diz quanto da RAM as variáveis globais usam. Se o programa não couber na flash, passa de 100 por cento, seguido do aviso Sketch too big e do erro text section exceeds available space in board. Se as variáveis globais não couberem na RAM, você vê Not enough memory e data section exceeds available space in board. Quando o uso de RAM passa de 75 por cento, o IDE pode mostrar o aviso Low memory available, stability problems may occur.: o código compila, mas, como não sobra espaço para as variáveis locais durante a execução, a placa pode travar aleatoriamente ou reiniciar sozinha. No Uno, o bootloader usa 0,5 KB dos 32 KB de flash, e é por isso que o limite é de 32256 bytes.

1// RAM tasarrufu: F() ve PROGMEM / Saving RAM: F() and PROGMEM
2const char mesaj[] PROGMEM = "Bu uzun metin RAM yerine flasta durur";   // flaşta saklanır / stored in flash
3const byte notalar[] PROGMEM = {60, 62, 64, 65, 67, 69, 71, 72};      // byte: int'in yarısı / byte: half of an int
4
5void setup() {
6  Serial.begin(9600);
7  Serial.println(F("Merhaba! Bu metin de flastan okunur"));   // F(): RAM harcamaz / F(): uses no RAM
8  char tampon[48];                                            // geçici RAM tamponu / temporary RAM buffer
9  strcpy_P(tampon, mesaj);                                    // flaştan RAM'e kopyala / copy from flash to RAM
10  Serial.println(tampon);
11  for (byte i = 0; i < sizeof(notalar); i++) {
12    Serial.print(pgm_read_byte(&notalar[i]));                 // flaştan bir bayt oku / read one byte from flash
13    Serial.print(' ');
14  }
15  Serial.println();
16}
17
18void loop() {
19}

• Coloque textos fixos dentro de F(): Serial.println(F("System ready")); lê o texto direto da flash, sem copiá-lo para a RAM. O mesmo vale para textos fixos que você mostra em displays LCD e OLED.
• Leve arrays grandes para a PROGMEM: se tabelas de notas, bitmaps de display e textos longos nunca mudam, eles não precisam ficar na RAM. Para técnicas mais detalhadas, veja o artigo memória insuficiente no Arduino.
• Escolha o tipo de dado certo: para um valor entre 0 e 255, byte (1 byte) basta; no Uno, um int ocupa 2 bytes, enquanto long e float ocupam 4.
• Use menos a classe String: objetos String que vivem sendo concatenados fragmentam a RAM; arrays de char de tamanho fixo são mais previsíveis.
• Conheça as necessidades ocultas das bibliotecas de display: a Adafruit SSD1306 aloca, durante a execução, um buffer de 1 KB para um display OLED de 0,96 polegada de 128×64. Essa memória não aparece no relatório de compilação, então o display pode não iniciar mesmo quando o relatório diz 70 por cento.
• Passe para uma placa maior: um projeto que não cabe no Uno roda tranquilo no Mega ou no ESP32. No ESP32, você pode aumentar a área de programa de 1,25 MB para 3 MB escolhendo Huge APP (3MB No OTA/1MB SPIFFS) em Ferramentas > Partition Scheme; com essa opção, as atualizações sem fio (OTA) não ficam disponíveis.

Erros causados pela escolha da placa errada

O compilador sempre compila o seu código para o processador da placa selecionada em Ferramentas > Placa (no IDE 2, no seletor de placa no topo). O mesmo código pode compilar sem problemas para o Mega e falhar com o Uno selecionado, porque cada placa tem hardware, nomes de pinos e bibliotecas diferentes, que vêm com o pacote da placa. Quando abrir um projeto que encontrou na internet, confira primeiro para qual placa ele foi escrito: código escrito para o ESP32 não compila com o Uno selecionado, e código escrito para o Uno que acessa os registradores do processador diretamente não compila com o ESP32 selecionado. Se você nem vê a sua placa na lista, o pacote dela não está instalado; você precisa instalar os pacotes do ESP32 e do Raspberry Pi Pico pelo Gerenciador de Placas. Para os passos, veja o guia Como instalar o Arduino IDE.

Erros de compilação no ESP32

O ESP32 também é programado na linguagem do Arduino, mas, como o compilador e o pacote de placa são diferentes, um código que compila sem problemas no Uno pode empacar no ESP32. O motivo mais comum é a versão do core: na versão 3.x do core Arduino do ESP32 as funções de PWM mudaram; ledcSetup() e ledcAttachPin() foram removidas e substituídas por ledcAttach() e ledcWrite(), que trabalham com o número do pino em vez de um número de canal. É por isso que exemplos antigos da internet dão 'ledcSetup' was not declared in this scope; converta o código para as funções novas ou instale a versão 2.0.17 pelo Gerenciador de Placas. A segunda diferença são as opções do compilador. O core do Uno compila o código com a opção -fpermissive, que transforma alguns erros em simples avisos; o ESP32 não a usa. Por exemplo, declarar uma variável dentro de um switch sem chaves compila no Uno, mas dá o erro jump to case label no ESP32. Os cores atuais do ESP32 também compilam com -Werror=return-type: se você esquecer o return em uma função que precisa retornar um valor, recebe no return statement in function returning non-void sempre que Avisos do compilador estiver em qualquer opção diferente de Nenhum. Na versão 2.x, colocar Avisos do compilador em Mais ou Todos transforma a maioria dos avisos em erros. Para a configuração básica da placa, dê uma olhada no artigo O que é o ESP32.

1// ESP32 Arduino paketi 3.x / ESP32 Arduino core 3.x
2const int LED_PIN = 2;        // birçok DevKit kartında dahili LED / onboard LED on many DevKit boards
3const int FREKANS = 5000;     // PWM frekansı 5 kHz / PWM frequency 5 kHz
4const int COZUNURLUK = 8;     // 8 bit: 0-255 arası / 8 bits: range 0-255
5
6int parlaklik(int adim) {
7  return (adim % 32) * 8;     // return unutulursa 3.x'te derleme hatası olabilir / a missing return can fail to compile on 3.x
8}
9
10void setup() {
11  Serial.begin(115200);
12  // eski 2.x kodu / old 2.x code: ledcSetup(0, FREKANS, COZUNURLUK); ledcAttachPin(LED_PIN, 0);
13  ledcAttach(LED_PIN, FREKANS, COZUNURLUK);   // 3.x: kanal otomatik seçilir / channel is picked automatically
14}
15
16void loop() {
17  for (int adim = 0; adim < 32; adim++) {
18    ledcWrite(LED_PIN, parlaklik(adim));      // 3.x: pin numarasıyla yaz / write using the pin number
19    delay(30);
20  }
21  if (Serial.available()) {
22    switch (Serial.read()) {
23      case 'h': {                             // case içinde değişken varsa süslü parantez şart / braces needed if a case declares a variable
24        int deger = ledcRead(LED_PIN);
25        Serial.println(deger);
26        break;
27      }
28      default:
29        break;
30    }
31  }
32}

Raspberry Pi Pico: erros no Arduino IDE e no MicroPython

Se você programa o Pico com o Arduino IDE, ou seja, com o core arduino-pico de Earle Philhower, o compilador continua sendo o GCC e todas as mensagens deste artigo valem do jeito que estão. O MicroPython é diferente: não há uma etapa de compilação separada antes; o Pico transforma o arquivo em bytecode quando começa e o executa linha por linha. Por isso os erros aparecem no painel Shell, na parte de baixo do Thonny, em uma mensagem que começa com Traceback (most recent call last):. Leia essa mensagem de baixo para cima: a última linha diz o tipo de erro e a descrição, e a parte line 7 acima dela diz em qual linha ele está. Erros de sintaxe (SyntaxError, IndentationError) são informados antes mesmo de o programa começar; os outros erros só aparecem quando o programa chega naquela linha, então o código pode funcionar bem por um tempo e depois parar. Para instalar o MicroPython e dar os primeiros passos, veja o artigo O que é o Raspberry Pi Pico.

1from machine import Pin
2import time
3
4led = Pin("LED", Pin.OUT)     # Pico ve Pico W dahili LED / onboard LED on Pico and Pico W
5sayac = 0
6
7while True:                   # iki nokta unutulursa SyntaxError / a missing colon gives SyntaxError
8    led.toggle()              # blok içinde 4 boşluk girinti / 4-space indent inside the block
9    sayac += 1
10    print("Sayac:", sayac)    # "Sayac: " + sayac yazmak TypeError verir / "Sayac: " + sayac raises TypeError
11    time.sleep(0.5)

Tabela de erros de compilação do Arduino e soluções

Próximos passos para escrever código sem erros

• Reforce o básico: o artigo fundamentos da programação Arduino explica variáveis, escopo, funções e laços; a maioria dos erros deste artigo vem desses temas.
• Aprenda a grafia correta dos comandos: a lista de comandos do Arduino mostra a sintaxe e os parâmetros de cada comando com exemplos.
• Instale as bibliotecas do jeito certo: o guia Como instalar uma biblioteca no Arduino trata em detalhes das mensagens No such file or directory e Multiple libraries were found.
• Veja o que o seu código faz enquanto roda: para um código que compila, mas não se comporta como você espera, mostrar as variáveis no Monitor Serial é o jeito mais rápido de diagnosticar.
• Teste sem placa: nos simuladores Wokwi ou Tinkercad, você pode compilar o código e rodá-lo junto com o circuito.
• Confira o código escrito por IA: o código gerado por chatbots muitas vezes é escrito para versões antigas de bibliotecas ou para outra placa; o artigo código Arduino com IA explica como pegar esses problemas.

Os erros de compilação podem assustar no começo, mas o compilador na verdade diz onde está o problema e muitas vezes como resolvê-lo: arquivo, linha, coluna e uma descrição curta. Leia o primeiro erro, corrija só ele, compile de novo e repita o ciclo; depois de alguns projetos, você vai se pegar resolvendo erros em segundos. Quando o seu código compilar e carregar, você pode seguir com os projetos de LED, botão, sensor e display do app BlueGrays: cada projeto para Arduino, ESP32 e Raspberry Pi Pico vem com esquema do circuito e código que compila sem erros, passo a passo.