00 — Prima di iniziare

Prerequisiti

Non è richiesta alcuna conoscenza preliminare di C++. Servono solo un PC Windows e una connessione internet. Verifica di avere tutto prima di procedere.

💻

Sistema operativo Windows 10 o 11, versione a 64-bit

🌐

Connessione internet VS Code ~100 MB · MSYS2 ~100 MB

🔑

Diritti amministratore Necessari per installare i programmi

⏱️

Tempo 25–35 min (dipende dalla connessione)

Software da scaricare

⬇️ Visual Studio Code code.visualstudio.com ⬇️ MSYS2 msys2.org

📌 Perché MSYS2 e non altri approcci? MSYS2 usa la variante UCRT64 (Universal C Runtime), compatibile con Windows 10/11 moderni. Fornisce il gestore di pacchetti pacman per installare e aggiornare g++, gdb e make esattamente come su Linux.

01–03 — Installazione

VS Code e MSYS2

1 — Installare Visual Studio Code

VS Code è un editor di codice open-source sviluppato da Microsoft. È gratuito, leggero e supporta decine di linguaggi.

Vai su code.visualstudio.com e clicca su "Download for Windows".
Avvia il file scaricato (VSCodeSetup-x64-*.exe) e segui l'installazione guidata.
Nella schermata "Select Additional Tasks" seleziona:
- ✅ Add "Open with Code" to Windows Explorer file context menu
- ✅ Add "Open with Code" to Windows Explorer directory context menu
- ✅ Register Code as an editor for supported file types
Clicca Install e attendi il completamento.

Pagina di download di Visual Studio Code — pulsante 'Download for Windows'

Figura 1 — Pagina ufficiale VS Code: pulsante di download per Windows

2 — Installare MSYS2

MSYS2 è l'ambiente che porta su Windows il toolchain di compilazione GNU, incluso il gestore di pacchetti pacman.

Vai su msys2.org e scarica l'installer (msys2-x86_64-*.exe).
Avvia l'installer e mantieni il percorso predefinito C:\msys64.
Al termine dell'installazione lascia attiva la spunta "Run MSYS2 now" e clicca Finish.

Schermata finale installazione MSYS2 con la spunta 'Run MSYS2 now' attiva

Figura 2 — Lascia la spunta attiva: si aprirà subito il terminale MSYS2 UCRT64

💡 Quale terminale si apre? Si aprirà il terminale MSYS2 UCRT64, riconoscibile dal prompt colorato. È il terminale corretto per il passaggio successivo.

3 — Installare g++, gdb e make

Nel terminale MSYS2 UCRT64 appena aperto, installa i tre pacchetti necessari con il comando seguente:

MSYS2 UCRT64 — terminale

pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gdb mingw-w64-ucrt-x86_64-make

💡 Installazione alternativa (se il comando sopra dà errori) In caso di problemi, usa il pacchetto completo del toolchain:
pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain

Alla domanda "Proceed with installation? [Y/n]" → digita Y e premi Invio.
Attendi il completamento del download (qualche minuto).
Verifica l'installazione con i tre comandi seguenti, uno alla volta:

Verifica — MSYS2 UCRT64

g++ --version
gdb --version
make --version

Terminale MSYS2 con l'output di g++ --version, gdb --version e make --version

Figura 3 — Ogni comando mostra la versione installata: l'installazione è riuscita

04–05 — Configurazione

PATH e verifica

📌 A cosa serve il PATH di Windows? La variabile di sistema Path è l'elenco delle cartelle in cui Windows cerca i programmi eseguibili. Aggiungere C:\msys64\ucrt64\bin permette di digitare g++ in qualsiasi terminale (CMD, PowerShell, terminale integrato di VS Code) senza dover scrivere il percorso completo ogni volta.

Se non hai i privilegi di amministratore e non riesci a modificare il PATH, puoi comunque usare VS Code con Ctrl+F5: VS Code salva internamente il percorso completo del compilatore e funziona lo stesso. L'unica limitazione è che g++ non sarà riconosciuto nel terminale integrato di VS Code o nel Prompt dei comandi di Windows.

4 — Aggiungere g++ al PATH di Windows

Aggiungiamo C:\msys64\ucrt64\bin alla variabile di sistema Path così che g++ sia riconoscibile da qualsiasi terminale.

Premi Win e digita variabili d'ambiente. Clicca su "Modifica le variabili d'ambiente del sistema".
Nella finestra "Proprietà del sistema" clicca su "Variabili d'ambiente…".

Finestra Proprietà del sistema con il pulsante Variabili d'ambiente

Figura 4 — Proprietà del sistema → "Variabili d'ambiente…"

Nella sezione Variabili di sistema (in basso), seleziona Path e clicca "Modifica…".

Finestra Variabili d'ambiente con la voce Path selezionata nella sezione variabili di sistema

Figura 5 — Seleziona "Path" nelle variabili di sistema → "Modifica…"

Clicca "Nuovo" e inserisci esattamente:

Percorso da aggiungere

C:\msys64\ucrt64\bin

$Finestra Modifica variabile d'ambiente con C:\msys64\ucrt64\bin aggiunto e evidenziato$

Figura 6 — Aggiungi C:\msys64\ucrt64\bin come nuova voce nella variabile Path

Clicca OK su tutte le finestre aperte.

⚠️ RIAVVIA IL PC ORA Le modifiche alle variabili d'ambiente sono attive solo dopo il riavvio. Salva tutto e riavvia prima di andare avanti.

5 — Verificare l'installazione

Dopo il riavvio, apri il Prompt dei comandi (Win+R → cmd → Invio) e lancia:

Prompt dei comandi — verifica finale

g++ --version
gdb --version

Prompt dei comandi Windows con l'output corretto di g++ --version

Figura 7 — Output corretto: g++ è riconosciuto dal Prompt dei comandi di Windows

💡 Il comando non viene riconosciuto? Controlla che C:\msys64\ucrt64\bin sia nella variabile di sistema Path (non utente), che MSYS2 sia installato in C:\msys64 e che tu abbia riavviato il PC dopo aver modificato il PATH.

06–07 — VS Code C++

Estensione C/C++ e Hello, World!

6 — Installare l'estensione C/C++

VS Code è un editor generico. L'estensione ufficiale Microsoft aggiunge IntelliSense, evidenziazione della sintassi e supporto al debugger.

Apri VS Code.
Clicca sull'icona Extensions nella barra sinistra o premi Ctrl+Shift+X.
Cerca C/C++ e installa l'estensione di Microsoft (la prima, con milioni di download).

Marketplace estensioni VS Code con l'estensione C/C++ di Microsoft

Figura 8 — Installa "C/C++" di Microsoft dal Marketplace di VS Code

VS Code con l'estensione C/C++ installata

Figura 9 — L'estensione è installata e pronta

7 — Hello, World!

Creiamo il primo programma C++. Crea una cartella dedicata (es. C:\progetti-cpp), aprila con File → Apri cartella… in VS Code e crea un file hello.cpp.

Al primo utilizzo VS Code potrebbe chiedere di selezionare il compilatore:

VS Code — dialogo di selezione del compilatore con g++.exe da C:/msys64/ucrt64/bin/

Figura 10 — Seleziona "Use g++.exe Found at C:/msys64/ucrt64/bin/"

VS Code con la schermata di benvenuto per lo sviluppo C++

Figura 11 — VS Code è configurato per C++ e pronto alla scrittura

Scrivi il codice nel file hello.cpp e salvalo con Ctrl+S nella cartella del progetto:

C++ · hello.cpp

#include <iostream>

using namespace std;

int main() {
    cout << "Hello, World!" << endl;
    return 0;
}

Premi Ctrl+F5 per compilare ed eseguire il programma senza il debugger (oppure: menu Run → Run Without Debugging).

⚠️ Se VS Code chiede di selezionare il compilatore Scegli C++ (GDB/LLDB), poi seleziona il file g++.exe in C:/msys64/ucrt64/bin/.
Non scegliere "cl.exe" — è il compilatore MSVC di Visual Studio, non installato.

Terminale VS Code con l'output Hello, World!

Figura 12 — Output nella finestra TERMINAL: Hello, World!

🎉 Fatto! L'ambiente di sviluppo C++ è pronto. Per i progetti successivi aggiungi sempre -Wall -std=c++17 alla compilazione:

Compilazione consigliata

g++ hello.cpp -o hello -Wall -std=c++17

# -Wall   → attiva tutti gli avvisi del compilatore (sempre consigliato)
# -std=c++17 → usa lo standard C++17 (raccomandato per nuovi progetti)

Riepilogo — checklist finale

VS Code installato e avviabile
MSYS2 installato in C:\msys64
g++, gdb e make installati tramite pacman
C:\msys64\ucrt64\bin aggiunto alla variabile di sistema Path
PC riavviato dopo la modifica al PATH
g++ --version riconosciuto nel Prompt dei comandi
Estensione C/C++ di Microsoft installata in VS Code
hello.cpp compilato ed eseguito correttamente

Link utili

📚 Docs C++ in VS Codecode.visualstudio.com (inglese) 🔄 Aggiornare MSYS2pacman -Syu 🔍 cppreference.comDocumentazione C++ completa ⬇️ Scarica questa guidaFormato Word (.docx)