Como instalar a Arduino IDE 2 no Windows, Mac e Linux (guia)

Instalar a Arduino IDE é o primeiro passo de qualquer projeto com Arduino e, feito na ordem certa, leva 10–15 minutos: você baixa o programa do site oficial do Arduino (arduino.cc/en/software), instala no seu sistema operacional, conecta a placa com um cabo USB, seleciona a placa e a porta e carrega o seu primeiro sketch de teste, o Blink. Quando o pequeno LED da placa começar a piscar uma vez por segundo, a instalação está pronta. Este guia se baseia na Arduino IDE 2 atual (versão 2.3.10 em outubro de 2026); você também encontra uma tabela que a compara com a antiga 1.8.19.

Abaixo você encontra instruções de instalação separadas, passo a passo, para Windows, macOS e Linux. Depois passamos um por um pelos drivers e pela porta COM, pelo seletor de placa, pelos botões Verificar e Carregar, pelo Monitor Serial, pelo Gerenciador de Bibliotecas e pelo Gerenciador de Placas. A adição dos pacotes de placas do ESP32 e do Raspberry Pi Pico, preferências como idioma e tamanho da fonte, o Arduino Cloud Editor, que dispensa instalação, e as soluções para os erros de instalação mais comuns também estão reunidos aqui.

O que é a Arduino IDE e qual versão baixar?

A Arduino IDE (Ambiente de Desenvolvimento Integrado) é o programa gratuito e de código aberto em que você escreve o código, compila, vê os erros e o carrega na placa pela USB. Nos bastidores, ela roda para você o compilador C++, os pacotes de placas e ferramentas de carregamento como o avrdude ou o esptool; você só aperta dois botões. A versão em desenvolvimento ativo hoje é a Arduino IDE 2: ela oferece autocompletar, tema escuro, um depurador embutido e um Plotter Serial redesenhado. A antiga 1.8.19 ainda pode ser baixada, mas só recebe correções críticas de segurança, então, se você está começando, instale a IDE 2 de uma vez.

Requisitos do sistema e escolha do arquivo certo

A página de download oferece vários arquivos para cada sistema operacional. A Arduino IDE 2 só funciona em sistemas de 64 bits; se você usa Windows de 32 bits ou um macOS muito antigo, sua única opção é a 1.8.19. Você confere o processador do seu Mac em menu Apple > Sobre Este Mac: se aparecer Chip: Apple M…, escolha Apple Silicon; se aparecer Processador: Intel, escolha a versão Intel.

Instalando a Arduino IDE no Windows

1. Baixe o instalador .exe do Windows na página de download e clique duas vezes nele. Se aparecer uma página pedindo doação, você pode seguir para o download sem doar.
2. Aceite o contrato de licença com I Agree. Depois escolha se quer instalar para todos os usuários do computador (Anyone who uses this computer) ou só para você (Only for me); em um computador da escola ou compartilhado, a primeira opção exige direitos de administrador.
3. Deixe a pasta de instalação como está e clique em Install. Quando terminar, mantenha Run Arduino IDE marcado e clique em Finish.
4. Se o Windows perguntar “Deseja instalar este software de dispositivo?” para os drivers USB do Arduino e de placas compatíveis, clique em Instalar; esses drivers permitem que placas como o Uno, o Mega e o Leonardo originais sejam reconhecidas. Se o firewall pedir acesso à rede, permita também.
5. Quando a IDE abrir, você vai ver no canto inferior direito notificações mostrando que o pacote Arduino AVR Boards e as bibliotecas embutidas estão sendo instalados. Fique conectado à internet e espere terminar; o suporte ao Uno, ao Nano e ao Mega vem com esse pacote.

Quando você conecta a placa, uma nova porta COM deve aparecer no Gerenciador de Dispositivos, em Portas (COM e LPT). Um Uno original aparece como Arduino Uno (COMx), enquanto os clones baratos com o chip CH340 aparecem como USB-SERIAL CH340 (COMx). Se um clone fica em Outros dispositivos como USB2.0-Serial, com um ponto de exclamação amarelo, falta o driver CH340; o Windows Update geralmente o instala sozinho e, se não instalar, instale o pacote CH341SER da fabricante do chip, a WCH. O chip CP2102, presente em muitas placas ESP32, precisa do driver CP210x VCP da Silicon Labs. Tratamos em detalhes a solução de problemas de porta e driver em Erro ao carregar o código no Arduino.

Instalando a Arduino IDE no macOS

1. Baixe o .dmg que corresponde ao seu processador e clique duas vezes nele. Na janela que abrir, arraste o ícone da Arduino IDE para a pasta Aplicativos.
2. Abra o app pelo Launchpad ou pelo Spotlight (Cmd + Espaço). Quando o sistema perguntar se você tem certeza de que quer abrir um app baixado da internet, clique em Abrir.
3. A IDE pode pedir acesso à pasta Documents/Arduino, onde guarda os seus sketches; permita, senão os sketches não podem ser salvos.
4. Na primeira vez que você conecta uma placa a um MacBook com Apple Silicon, pode aparecer a pergunta “Permitir que o acessório se conecte?”. Se você não clicar em Permitir, a placa nunca aparece na lista de portas.
5. Na lista de portas, um Uno original aparece como /dev/cu.usbmodem…, enquanto os clones com CH340 aparecem como /dev/cu.usbserial-… ou /dev/cu.wchusbserial…. As versões recentes do macOS já trazem drivers para o CH340 e o CP2102; instalar drivers antigos por cima geralmente piora as coisas.

Nos Macs com Apple Silicon, as ferramentas de alguns pacotes de placas ainda são feitas para processadores Intel. Se aparecer o erro bad CPU type in executable ao compilar ou carregar, abra o Terminal e instale o Rosetta 2 com softwareupdate --install-rosetta; a camada de tradução da Apple permite que essas ferramentas Intel rodem nos chips da série M. Se o erro continuar, atualize o pacote de placas em questão para a versão mais recente no Gerenciador de Placas.

Instalando a Arduino IDE no Linux (AppImage)

1. Baixe o AppImage. Um AppImage é um pacote de aplicativo em um único arquivo que não precisa de instalação; se quiser, mova-o para um lugar fixo na sua pasta pessoal.
2. Torne o arquivo executável: clique nele com o botão direito e, em Propriedades > Permissões, marque Permitir execução do arquivo como programa. Rodar chmod +x arduino-ide_*_Linux_64bit.AppImage em um terminal faz o mesmo.
3. Clique duas vezes no arquivo para iniciar a IDE. Se aparecer dlopen(): error loading libfuse.so.2 ou AppImages require FUSE to run, falta a biblioteca FUSE 2: rode sudo apt install libfuse2 no Ubuntu 22.04, ou sudo apt install libfuse2t64 no Ubuntu 24.04 e posteriores.
4. Adicione o seu usuário ao grupo dialout para acessar as portas seriais: sudo usermod -a -G dialout $USER. Reinicie o computador para a mudança valer; senão os carregamentos falham com Permission denied.
5. Se a porta de uma placa com chip CH340 ou CP2102 aparece por um instante e some, o serviço brltty, pré-instalado para displays em braille, está capturando a porta. Se você não usa display em braille, remova-o com sudo apt remove brltty e depois desconecte e reconecte a placa.
6. Se a IDE nem abre no Ubuntu 24.04 e o terminal mostra The SUID sandbox helper binary was found, but is not configured correctly, o AppArmor está bloqueando a sandbox do app. Como solução temporária, você pode iniciar a IDE por um terminal com a opção --no-sandbox.

Um passeio pela interface da Arduino IDE 2

Quando você abre a IDE pela primeira vez, é recebido por um sketch vazio: esse esqueleto formado pelas funções setup() e loop() é a base de todo programa Arduino. No mundo Arduino, os programas se chamam sketches, e cada sketch é guardado como um arquivo .ino dentro de uma pasta com o mesmo nome. A janela é dividida em quatro áreas: a barra de ferramentas e o seletor de placa em cima, a barra lateral à esquerda, o editor de código no meio e, embaixo, o painel Saída, onde passam as mensagens do compilador, mais o Monitor Serial. A barra de status, bem embaixo, mostra o número da linha do cursor e a placa e a porta selecionadas.

Selecionando a placa e a porta

A seleção da placa diz à IDE para qual processador compilar e com qual ferramenta carregar; a seleção da porta aponta para a placa física ligada ao computador. Você não consegue carregar se as duas não estiverem certas. Depois de conectar a placa, abra o seletor de placa no topo: um Uno original aparece pelo nome e pode ser escolhido com um clique. Com clones CH340, porém, a IDE não consegue identificar a placa e a porta aparece como Desconhecida. Nesse caso, abra Selecionar outra placa e porta, digite “uno” na caixa de busca, escolha Arduino Uno à esquerda e a porta à direita e clique em OK. Se você não tem certeza de qual porta é a da sua placa, desconecte-a, olhe a lista e conecte de novo: a porta que aparecer é a sua.

Carregando o seu primeiro sketch: o Blink passo a passo

1. Vá em Arquivo > Exemplos > 01.Basics > Blink. O exemplo abre em uma nova janela; é um sketch pronto que vem com a IDE e pisca o LED da placa.
2. Escolha a sua placa e a sua porta no seletor de placa; a barra de status embaixo deve mostrar agora o nome e a porta da sua placa.
3. Primeiro clique em Verificar (Ctrl+R). Se o painel Saída mostrar O sketch usa 924 bytes (2%) de espaço de armazenamento para programas. O máximo são 32256 bytes., a compilação deu certo.
4. Depois clique em Carregar (Ctrl+U). Os LEDs TX e RX da placa piscam rapidamente e aparece no canto inferior direito a notificação Carregamento concluído.
5. O LED marcado L deve agora ficar aceso por um segundo e apagado por um segundo. Para ter certeza de que o seu código novo foi mesmo carregado, troque as duas linhas delay(1000) por delay(200) e carregue de novo; se a piscada acelerar, está tudo funcionando.
6. Quando você tenta salvar o exemplo modificado, a IDE pede um nome e um local novos, porque os exemplos ficam na pasta do próprio programa. Os seus sketches são salvos por padrão na pasta Documents/Arduino, o seu Sketchbook.

Essas linhas da saída falam da memória da sua placa. O bootloader ocupa 512 bytes dos 32 KB de memória flash do ATmega328P do Uno, e é por isso que sobram 32256 bytes para o seu código, dos quais o Blink usa só 2%. A linha Variáveis globais usam 9 bytes, logo abaixo, diz quanto dos 2048 bytes de RAM está reservado para variáveis globais. Conforme seus projetos crescem, ficar de olho nessas porcentagens muitas vezes responde ao “por que minha placa trava?” antes mesmo de você precisar perguntar. Agora escreva o seu próprio primeiro sketch: o código abaixo acrescenta ao Blink algumas linhas que enviam mensagens ao Monitor Serial, então você testa ao mesmo tempo o carregamento e a troca de dados pela USB.

1// İlk test: dahili LED yanıp söner, Seri Port Ekranı'na yazı gelir
2// First test: blinks the onboard LED and prints to the Serial Monitor
3int sayac = 0;                        // kaç kez yanıp söndü / blink counter
4
5void setup() {
6  pinMode(LED_BUILTIN, OUTPUT);       // Uno'da pin 13 (L LED'i) / pin 13 (L LED) on the Uno
7  Serial.begin(9600);                 // Seri Port Ekranı hızı / Serial Monitor baud rate
8  Serial.println("Merhaba BlueGrays! / Hello BlueGrays!");
9}
10
11void loop() {
12  digitalWrite(LED_BUILTIN, HIGH);    // LED'i yak / turn the LED on
13  delay(1000);                        // 1 saniye bekle / wait 1 second
14  digitalWrite(LED_BUILTIN, LOW);     // LED'i söndür / turn the LED off
15  delay(1000);
16  sayac++;
17  Serial.print("Yanip sonme / Blink: ");
18  Serial.println(sayac);
19}

O setup() roda uma vez quando a placa liga ou reinicia: aqui definimos o pino 13 como saída e iniciamos a comunicação serial a 9600 baud. Depois, o loop() se repete sem fim enquanto a placa tiver energia. LED_BUILTIN é o nome do pino em que o LED da placa está ligado; no Uno, no Nano e no Mega ele vale 13, então o mesmo código roda nessas placas sem mudanças. Para uma explicação detalhada dos comandos deste código, dê uma olhada em Comandos do Arduino.

Monitor Serial e Plotter Serial

Depois de carregar, clique no ícone de lupa no canto superior direito ou aperte Ctrl+Shift+M. O Monitor Serial abre no painel inferior e mostra uma linha nova a cada piscada da placa. O menu de baud rate no canto superior direito do painel precisa bater com o valor do Serial.begin() no código, ou seja, 9600 baud; se não bater, a tela se enche de caracteres sem sentido. Digite na caixa de mensagem no topo e aperte Enter para enviar texto à placa. O menu de final de linha ao lado oferece Sem final de linha, Nova linha, Retorno de carro e Ambos, NL e CR; escolha o que o seu código espera.

O Plotter Serial mostra números como gráfico: se você envia linhas com rótulo, como Serial.print("light:"); Serial.println(value);, cada rótulo vira uma linha com a própria cor. É ideal para acompanhar ao vivo os valores de um potenciômetro ou de um LDR. Durante o carregamento, confira se nenhum outro programa (uma segunda janela da IDE, o PuTTY, um script Python) está segurando a porta, porque uma porta só pode estar aberta em um programa por vez. Reunimos todos os detalhes dessas ferramentas em Monitor Serial do Arduino.

Gerenciador de Bibliotecas e Gerenciador de Placas

Boa parte do poder do Arduino vem das bibliotecas prontas. Abra o Gerenciador de Bibliotecas pelo ícone de livros na barra lateral esquerda (Ctrl+Shift+I), digite o nome da biblioteca na caixa de busca (por exemplo, “DHT sensor library”) e clique em Instalar. Se a biblioteca depende de outras bibliotecas, a IDE pergunta; escolher Instalar tudo evita erros de arquivo faltando desde o início. As bibliotecas instaladas vão para a pasta libraries do seu Sketchbook, e os exemplos delas são adicionados ao menu Arquivo > Exemplos. Arquivos ZIP baixados da internet são instalados com Sketch > Incluir Biblioteca > Adicionar biblioteca .ZIP...; os detalhes estão em Como adicionar uma biblioteca no Arduino.

Já o Gerenciador de Placas (Ctrl+Shift+B) instala compiladores e ferramentas de carregamento para diferentes famílias de processadores. O pacote do Uno, do Nano e do Mega chega automaticamente na primeira abertura; para placas como o Uno R4, o ESP32 ou o Pico, você instala o pacote correspondente uma vez. As placas do próprio Arduino aparecem direto na lista, enquanto as placas de outros fabricantes precisam primeiro de uma URL de pacote adicionada nas Preferências. Os pacotes de placas não são instalados no seu Sketchbook, e sim em uma pasta separada chamada Arduino15: C:\Users\username\AppData\Local\Arduino15 no Windows, ~/Library/Arduino15 no macOS e ~/.arduino15 no Linux.

Adicionando o pacote de placas do ESP32

1. Abra Arquivo > Preferências (Ctrl+,) e cole esta URL no campo URLs do Gerenciador de Placas Adicionais: https://espressif.github.io/arduino-esp32/package_esp32_index.json. Para adicionar mais de uma URL, clique no ícone ao lado do campo e coloque cada URL em uma linha.
2. Clique em OK, depois abra o Gerenciador de Placas e digite esp32 na caixa de busca.
3. Encontre esp32 by Espressif Systems e clique em Instalar. O pacote tem centenas de megabytes, então o download pode levar vários minutos em uma conexão lenta. O pacote Arduino ESP32 Boards, que também aparece, é só para o Arduino Nano ESP32; para placas ESP32 genéricas, instale o pacote da Espressif.
4. Selecione ESP32 Dev Module como placa e a porta da sua placa. Como a maioria das ESP32 DevKits usa um chip CP2102 ou CH340, a IDE mostra a placa como Desconhecida; isso é normal.
5. Carregue o sketch de teste abaixo e coloque o Monitor Serial em 115200 baud. Se a saída mostrar Connecting.... sem parar, segure o botão BOOT da placa e solte quando as porcentagens do carregamento começarem a correr.

1// ESP32 kurulum testi: yonga bilgisi + LED / ESP32 setup test: chip info + LED
2const int LED_PIN = 2;   // çoğu ESP32 DevKit'te dahili LED / onboard LED on most DevKits
3
4void setup() {
5  pinMode(LED_PIN, OUTPUT);
6  Serial.begin(115200);  // ESP32 için yaygın hız / common ESP32 baud rate
7  delay(1000);           // Seri Port Ekranı açılsın diye bekle / give the monitor time to open
8  Serial.print("Model: ");
9  Serial.println(ESP.getChipModel());                  // ör. ESP32-D0WD-V3 / e.g. ESP32-D0WD-V3
10  Serial.print("Cekirdek / Cores: ");
11  Serial.println(ESP.getChipCores());
12  Serial.print("CPU (MHz): ");
13  Serial.println(ESP.getCpuFreqMHz());
14  Serial.print("Flash (MB): ");
15  Serial.println(ESP.getFlashChipSize() / (1024 * 1024));
16  Serial.print("Bos RAM / Free heap (bayt / bytes): ");
17  Serial.println(ESP.getFreeHeap());
18}
19
20void loop() {
21  digitalWrite(LED_PIN, !digitalRead(LED_PIN));        // LED'i ters çevir / toggle the LED
22  delay(500);
23}

Se o Monitor Serial mostrar o modelo do chip, o número de núcleos, a velocidade de 240 MHz da CPU e o tamanho da flash, geralmente 4 MB, a configuração do seu ESP32 está pronta; se a sua placa tem um LED no GPIO 2, ele também pisca a cada meio segundo. Os pinos do ESP32, a conexão ao Wi-Fi e um primeiro projeto controlado pelo celular estão em O que é ESP32?

Adicionando o pacote de placas do Raspberry Pi Pico

1. Nas Preferências, adicione esta URL em uma linha separada, abaixo da URL do ESP32, na lista URLs do Gerenciador de Placas Adicionais: https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json.
2. Busque pico no Gerenciador de Placas e instale o pacote Raspberry Pi Pico/RP2040/RP2350 de Earle F. Philhower. Esse pacote da comunidade suporta o Pico, o Pico W, o Pico 2 e o Pico 2 W e funciona com a maioria das bibliotecas do Arduino.
3. Selecione Raspberry Pi Pico como placa, ou o modelo que você realmente tem (Pico W, Pico 2).
4. No primeiro carregamento, segure o botão BOOTSEL do Pico enquanto conecta o cabo USB e depois solte. O Pico aparece no computador como uma unidade chamada RPI-RP2 (RP2350 no Pico 2) e UF2 Board aparece na lista de portas; selecione essa porta e clique em Carregar.
5. Quando o código começa a rodar, o Pico abre uma porta serial comum. Selecione essa nova porta na lista; nos próximos carregamentos você não precisa mais do BOOTSEL, porque a IDE reinicia a placa sozinha.

1// Pico kurulum testi: dahili LED + yonga sıcaklığı
2// Pico setup test: onboard LED + chip temperature
3void setup() {
4  pinMode(LED_BUILTIN, OUTPUT);   // Pico'da GP25; Pico W'de kablosuz yonga üzerinden / GP25 on Pico, via the wireless chip on Pico W
5  Serial.begin(115200);           // USB seri port / USB serial port
6}
7
8void loop() {
9  digitalWrite(LED_BUILTIN, HIGH);
10  delay(500);
11  digitalWrite(LED_BUILTIN, LOW);
12  delay(500);
13  Serial.print("Yonga sicakligi / Chip temperature (C): ");
14  Serial.println(analogReadTemp());   // dahili sensör, yaklaşık değer / internal sensor, approximate
15}

Se você quer programar o Pico em MicroPython, usa o Thonny em vez da Arduino IDE; você encontra as diferenças entre as duas abordagens e como instalar o MicroPython em O que é Raspberry Pi Pico? Lembre que carregar pela Arduino IDE apaga o MicroPython da placa. Para voltar, basta gravar de novo o arquivo UF2 do MicroPython usando o método do BOOTSEL.

Preferências: idioma, tamanho da fonte e outros ajustes

Abra a janela de Preferências em Arquivo > Preferências (no macOS, no menu do app Arduino IDE) ou com Ctrl+,. Para mudar a interface para outro idioma, escolha-o na lista Idioma e clique em OK; depois de um breve recarregamento, a IDE abre com os menus traduzidos. As mensagens de erro do compilador continuam em inglês. Estes são os ajustes mais úteis para iniciantes:

Arduino Cloud Editor: programe no navegador sem instalar nada

Se você não pode instalar programas no computador (um computador da escola, um Chromebook ou um notebook sem direitos de administrador), o Arduino Cloud Editor é uma boa alternativa. Você entra em app.arduino.cc com uma conta Arduino gratuita e cria um sketch novo na seção Sketches; o seu código fica guardado na nuvem e abre do mesmo jeito em qualquer computador. No Windows, no macOS e no Linux, você precisa instalar uma vez um pequeno programa de segundo plano chamado Arduino Cloud Agent para carregar na placa pela USB. No Chromebook, usa-se o navegador ou o app Arduino Cloud for Chromebook no lugar do agente, mas ali só o Uno R3, o Uno R4 e algumas outras placas oficiais do Arduino são suportados. Você também pode usar as duas ferramentas juntas: se entrar com a sua conta Arduino na IDE 2, o Cloud Sketchbook permite que a IDE de casa e o Cloud Editor da escola vejam os mesmos sketches.

Problemas comuns de instalação e como resolver

Instalação pronta: e agora?

• Domine o básico: aprenda como a placa, os pinos e a programação se encaixam em O que é Arduino? e veja os comandos mais usados no guia Comandos do Arduino.
• Monte o seu primeiro circuito: em vez do LED da placa, faça o Blink com um LED e um resistor na protoboard; encontre o resistor certo com a calculadora de resistor para LED e confira onde fica cada pino na ferramenta de pinagem.
• Teste sem placa: se você ainda não tem uma placa, simule no navegador com o Tinkercad ou o Wokwi.
• Aprenda a resolver erros: quando esbarrar em mensagens vermelhas, veja os guias sobre erros de carregamento e erros de compilação.
• Parta para o sem fio: se você instalou o pacote do ESP32, monte o seu primeiro projeto com Wi-Fi com O que é ESP32?
• Escolha a placa certa: se você ainda não comprou uma placa, dê uma olhada em Qual Arduino comprar? e Kit Arduino para iniciantes.

Quando a Arduino IDE está bem configurada, ela funciona sem problemas por anos; ao ganhar uma placa nova, basta instalar o pacote dela no Gerenciador de Placas e selecionar a placa e a porta certas. Se o Blink está funcionando, você está pronto: no app BlueGrays você encontra dezenas de projetos para Arduino, ESP32 e Raspberry Pi Pico, de LEDs piscando e semáforos a sensores de distância e projetos com Wi-Fi, cada um com esquema do circuito, lista de peças e código explicado passo a passo, que você pode testar na hora na sua IDE recém-instalada.