Prima di scrivere codice conviene riconoscere dove si trovano progetto, sorgente e messaggi. La disposizione può variare con la versione e con i pannelli spostati dall’utente; le funzioni rimangono identificabili dai nomi.
La mappa della finestra principale

Schema esplicativo originale creato per il capitolo.
La parte superiore raccoglie menu e barre degli strumenti. A sinistra si trova normalmente il pannello di gestione con il workspace e i progetti. Al centro si aprono i documenti in schede. In basso compaiono log e diagnosi. Una console separata ospita normalmente il programma console avviato.
Queste aree non sono intercambiabili. Scrivi il C o il C++ nell’editor; leggi il compilatore nei log; digita i dati richiesti dal tuo programma nella console. Se fai clic nel pannello sbagliato, la tastiera agirà in un contesto diverso da quello previsto.
I menu e le barre degli strumenti
I menu raggruppano le azioni per funzione. File riguarda documenti e progetti; Edit modifica il testo; View gestisce viste e disposizione; Build costruisce e avvia; Debug controlla l’esecuzione assistita; Settings ospita impostazioni e configurazioni.
Le icone forniscono scorciatoie alle azioni. Una forma simile a un ingranaggio o a un triangolo non basta a comprenderne l’effetto: passa il mouse e leggi il suggerimento. Per i primi passi usa il nome del comando nel menu, che rende più evidente la distinzione tra Build, Run e Build and run.
La presenza di un pulsante non garantisce che sia utilizzabile. Può essere disabilitato perché manca un progetto attivo, perché una build è in corso o perché il debugger non è disponibile nella configurazione corrente.
Management, workspace e progetto attivo
Il pannello Management mostra normalmente la scheda Projects e altre viste. Il workspace è un contenitore di progetti; il progetto elenca sorgenti, impostazioni e target. L’albero è una rappresentazione organizzata, non necessariamente una copia esatta delle directory del disco.
Espandi il progetto per vedere gruppi come Sources e Headers, quando presenti. Un doppio clic su un sorgente lo apre nell’editor. Se hai più progetti, verifica quale è attivo prima di costruire o avviare: il file visibile al centro può appartenere a un progetto diverso.

Schema esplicativo originale creato per il capitolo.
Un file può esistere sul disco senza essere incluso nella build. Al contrario un progetto può conservare un riferimento a un file che è stato spostato o eliminato. In entrambi i casi l’editor può mostrare informazioni diverse da quelle che ti aspetti dalla cartella.
L’editor e le schede dei documenti
La scheda identifica il documento aperto. Prima di scrivere, controlla il nome: main.c e main.cpp appartengono a percorsi linguistici diversi. Il contenuto è testo salvato nel file, mentre colori, numeri di riga e suggerimenti sono presentazioni dell’IDE.
Una modifica non salvata viene indicata secondo la versione e il tema, spesso con un segno accanto al nome. Usa File → Save per il documento o Save all per salvare tutti i documenti modificati. Una build deve elaborare la versione che intendi eseguire.
Il margine dell’editor contiene numeri di riga e può ospitare breakpoint. Un breakpoint è un’istruzione al debugger per interrompere l’esecuzione; non è una riga di codice aggiunta al programma. I colori evidenziano categorie della sintassi, ma non dimostrano che la compilazione riesca.
Le parentesi e l’indentazione aiutano a seguire la struttura. In C e C++ le graffe delimitano i blocchi; il rientro rende leggibile questa struttura senza sostituire le graffe mancanti.
Selezione del target: Debug e Release
Il selettore del target indica quale configurazione di build verrà utilizzata. Un progetto console creato dal wizard propone comunemente Debug e Release. I nomi rappresentano configurazioni con impostazioni differenti, non due documenti da scrivere separatamente.
Debug è il percorso iniziale adatto a osservare il programma e predisporre informazioni per il debugger. Release può adottare ottimizzazioni e scelte di distribuzione. I valori effettivi dipendono dalle opzioni del progetto: il nome da solo non è una garanzia delle impostazioni.
Un eseguibile Debug e uno Release possono essere prodotti in cartelle differenti. Se ne apri uno manualmente dalla cartella, controlla quale stai avviando. Una modifica compilata in Debug non aggiorna automaticamente l’eseguibile già presente nella cartella Release.
Logs & others, Build log e Build messages
Il pannello inferiore raccoglie viste con finalità diverse. Build log mostra lo svolgimento della costruzione e i messaggi degli strumenti. Build messages offre una presentazione delle diagnosi, spesso con file e posizione cliccabili.

Schema esplicativo originale creato per il capitolo.
Se la compilazione si ferma, apri il log completo e leggi la prima diagnosi significativa. Non tutti i messaggi hanno lo stesso peso: un avviso può permettere la build, un errore può impedirla, una riga informativa può limitarsi a indicare il file in elaborazione.
Non digitare gcc, sudo apt o il tuo nome in Build log. È una vista dei risultati dell’IDE. Il terminale del sistema e la console del programma sono superfici differenti e verranno indicate esplicitamente quando servono.
La console del programma
Quando avvii un’applicazione console compare normalmente una finestra o un terminale dedicato, secondo piattaforma e configurazione. Qui si vede ciò che il programma stampa e si inseriscono i dati che il programma richiede.
Se l’esempio mostra «Inserisci la quantità:», fai clic nella console, digita un numero e premi Invio. Non inserire il numero nel sorgente al posto della variabile né nella barra di ricerca dell’IDE. Il programma sta aspettando dati durante l’esecuzione.
Un messaggio finale del console runner può mostrare durata, codice di uscita e attesa di un tasto. Queste righe appartengono al meccanismo di avvio dell’IDE, non necessariamente alle istruzioni stampate dal tuo codice.
Recuperare una vista e mantenere leggibile la finestra
Se una vista viene chiusa, cerca la corrispondente voce nel menu View. Nomi e raggruppamenti possono variare: individua Management o il pannello dei log in base alla funzione che manca. Non reinstallare l’IDE perché un pannello è stato nascosto.
I bordi dei pannelli possono essere trascinati per lasciare spazio all’editor o alle diagnosi. Su uno schermo piccolo conviene alternare le viste anziché ridurre il testo fino a renderlo illeggibile. Una disposizione salvata dell’interfaccia riguarda l’ambiente, non il contenuto del progetto.
Controlla infine progetto attivo, target e scheda del documento prima di ogni build. Questa lettura della finestra evita di interpretare un vecchio risultato o un altro progetto come effetto delle modifiche appena effettuate.