Usando CLion com ESP32

Intro

O CLion é uma excelente escolha de IDE para o ecossistema da Espressif, pois ele possui suporte nativo ao CMake, que é o sistema de compilação oficial da ESP-IDF.

Obs.: Supõe-se que você já instalou a interface gráfica da Espressif (ESP-IDF Tools). Então o compilador e as ferramentas já estão no seu computador.

Configurando o CLion do Zero

O segredo para o CLion funcionar com o ESP32 é fazer a IDE enxergar o ambiente (variáveis e compilador) que a ferramenta da Espressif instalou.

Passo 1: Configurar as Variáveis de Ambiente no CLion

Antes de abrir o projeto, o CLion precisa saber onde a ESP-IDF está instalada.

1. Abra o CLion e vá em Settings (Configurações) ou Ctrl + Alt + S (Windows/Linux) ou Cmd + , (macOS).

2. Navegue até Build, Execution, Deployment > Toolchains.

3. Em Environment file, aponte para o script de inicialização que a Espressif criou na sua instalação:

   • Windows: Procure pelo arquivo export.bat dentro da pasta onde a ESP-IDF foi instalada.
   • Linux/macOS: Procure pelo arquivo export.sh.

4. Clique em Apply. Isso garante que o CLion use o compilador correto do ESP32 (Xtensa) e não o do seu computador.

Passo 2: Abrir o seu código

Supondo que você já tem um código exemplo, ele deve conter um arquivo chamado CMakeLists.txt na raiz (padrão de projetos ESP-IDF):

1. No CLion, clique em Open.
2. Selecione a pasta raiz do seu projeto exemplo e clique em OK.
3. Escolha a opção Open as Project.
4. O CLion começará a indexar o projeto. Aguarde o processo terminar (uma barra de progresso sumirá no canto inferior direito).

Passo 3: Compilar e Gravar (Flash)

O CLion lerá o arquivo CMakeLists.txt e criará automaticamente os alvos (targets) de compilação no canto superior direito.

1. No menu de seleção de alvos (ao lado do botão de Play), selecione app para compilar apenas o código.
2. Para gravar na placa, selecione o alvo flash.
3. Clique no botão de Play (ícone verde) para executar a ação selecionada.

Fernando Passold, em 30/09/2026