Usare il set di strumenti Microsoft C++ dalla riga di comando

È possibile compilare applicazioni C e C++ dalla riga di comando usando gli strumenti inclusi in Visual Studio. Il set di strumenti del compilatore Microsoft C++ (MSVC) è anche scaricabile come pacchetto autonomo. Non è necessario installare l'IDE di Visual Studio se non si prevede di usarlo.

Nota

Questo articolo descrive come configurare un ambiente per usare i singoli compilatori, linker, bibliotecari e altri strumenti di base. Il sistema di compilazione del progetto nativo in Visual Studio, basato su MSBuild, non usa l'ambiente come descritto in questo articolo. Per altre informazioni su come usare MSBuild dalla riga di comando, vedere MSBuild nella riga di comando - C++.

Scaricare e installare gli strumenti

Se Visual Studio e un carico di lavoro C++ sono stati installati, sono disponibili tutti gli strumenti da riga di comando. Per informazioni su come installare C++ e Visual Studio, vedere Installare il supporto C++ in Visual Studio. Se si vuole solo il set di strumenti da riga di comando, scaricare Build Tools per Visual Studio. Quando si esegue l'eseguibile scaricato, viene aggiornato ed eseguito il Programma di installazione di Visual Studio. Per installare solo gli strumenti necessari per lo sviluppo C++, selezionare il carico di lavoro Sviluppo di applicazioni desktop con C++ . È possibile selezionare librerie e set di strumenti facoltativi da includere in Dettagli installazione. Per compilare codice usando i set di strumenti di Visual Studio 2015, 2017 o 2019, selezionare gli strumenti di compilazione facoltativi MSVC v140, v141 o v142. Quando si è soddisfatti delle selezioni, scegliere Installa.

Come usare gli strumenti da riga di comando

Quando si sceglie uno dei carichi di lavoro di C++ nel programma di installazione di Visual Studio, verrà installato il set di strumenti della piattaforma di Visual Studio. Un set di strumenti della piattaforma include tutti gli strumenti C e C++ per una versione specifica di Visual Studio. Gli strumenti includono i compilatori C/C++, i linker, gli assembler e altri strumenti di compilazione e le librerie e i file di intestazione corrispondenti. È possibile usare tutti questi strumenti dalla riga di comando. Vengono usati internamente anche dall'IDE di Visual Studio. Sono disponibili compilatori e strumenti ospitati x86 e x64 separati per compilare codice per destinazioni x86, x64, ARM e ARM64. Ogni set di strumenti per un'architettura di compilazione per un host e una destinazione specifici viene archiviato nella relativa directory.

Per funzionare correttamente, gli strumenti richiedono l'impostazione di diverse variabili di ambiente specifiche, Queste variabili vengono usate per aggiungere gli strumenti al percorso e per impostare i percorsi dei file di inclusione, dei file di libreria e degli SDK. Per semplificare l'impostazione di queste variabili di ambiente, il programma di installazione crea file di comando personalizzati, o file batch, durante l'installazione. È possibile eseguire uno di questi file di comando per impostare un'architettura di compilazione host e di destinazione specifica, una versione di Windows SDK e un set di strumenti della piattaforma. Per praticità, il programma di installazione crea anche collegamenti nel menu Start. I collegamenti aprono le finestre del prompt dei comandi per sviluppatori usando questi file di comando per combinazioni specifiche di host e destinazione. Questi collegamenti assicurano che tutte le variabili di ambiente necessarie siano impostate e pronte per l'uso.

Le variabili di ambiente necessarie sono specifiche per l'installazione e per l'architettura di compilazione scelta. Possono anche essere modificati dagli aggiornamenti o dagli aggiornamenti del prodotto. Questa variabilità è un motivo per cui è consigliabile usare un collegamento al prompt dei comandi installato o un file di comando, anziché impostare manualmente le variabili di ambiente.

I set di strumenti, i file di comando e i collegamenti installati dipendono dal processore del computer e dalle opzioni selezionate durante l'installazione. Gli strumenti ospitati in x86 e gli strumenti incrociati che compilano codice x86 e x64 vengono sempre installati. Se si dispone di Windows a 64 bit, vengono installati anche gli strumenti ospitati x64 e gli strumenti incrociati che compilano codice x86 e x64. Se si sceglie gli strumenti di piattaforma UWP (Universal Windows Platform) C++ facoltativi, vengono installati anche gli strumenti x86 e x64 che compilano il codice ARM e ARM64. Altri carichi di lavoro possono installare questi e altri strumenti.

Percorso e variabili di ambiente per le compilazioni da riga di comando

Gli strumenti da riga di comando MSVC usano le PATHvariabili di ambiente , TMP, INCLUDELIB, e e LIBPATH usano anche altre variabili di ambiente specifiche per gli strumenti, le piattaforme e gli SDK installati. Anche una semplice installazione di Visual Studio può impostare venti o più variabili di ambiente. Questa complessità è il motivo per cui è consigliabile usare un collegamento al prompt dei comandi per gli sviluppatori o uno dei file di comando personalizzati. Non è consigliabile impostare manualmente queste variabili nell'ambiente Windows.

Per visualizzare le variabili di ambiente impostate da un collegamento al prompt dei comandi per gli sviluppatori, è possibile usare il SET comando . Aprire una normale finestra del prompt dei comandi e acquisire l'output del SET comando per una baseline. Aprire una finestra del prompt dei comandi per gli sviluppatori e acquisire l'output del comando per il SET confronto. Usare uno strumento diff, ad esempio quello integrato in Visual Studio, per evidenziare le variabili di ambiente impostate dal prompt dei comandi per gli sviluppatori. Per altre informazioni sulle variabili di ambiente del compilatore e del linker, vedere Variabili di ambiente CL.

Collegamenti al prompt dei comandi per gli sviluppatori

I collegamenti al prompt dei comandi vengono installati in una cartella di Visual Studio specifica della versione nel menu Start di Windows. Ecco un elenco dei collegamenti del prompt dei comandi principali e delle architetture di compilazione supportate:

• Prompt dei comandi per gli sviluppatori: imposta l'ambiente per l'uso di strumenti nativi x86 a 32 bit per compilare codice nativo x86 a 32 bit.
• Prompt dei comandi degli strumenti nativi x86: imposta l'ambiente per l'uso di strumenti nativi x86 a 32 bit per compilare codice nativo x86 a 32 bit.
• Prompt dei comandi degli strumenti nativi x64: imposta l'ambiente per l'uso di strumenti nativi x64 a 64 bit per compilare codice nativo x64 a 64 bit.
• Prompt dei comandi degli strumenti x86_x64: imposta l'ambiente per l'uso di strumenti nativi x86 a 32 bit per compilare codice nativo x64 a 64 bit.
• Prompt dei comandi degli strumenti x64_x86: imposta l'ambiente per l'uso di strumenti nativi x64 a 64 bit per compilare codice nativo x86 a 32 bit.

I nomi di menu Start cartella e collegamento variano a seconda della versione installata di Visual Studio. Se ne imposti uno, dipendono anche dal nome alternativo dell'installazione. Si supponga, ad esempio, di aver installato Visual Studio 2022 e di aver assegnato un nome alternativo latest. Il collegamento al prompt dei comandi per gli sviluppatori è denominato Prompt dei comandi per gli sviluppatori per VS 2022 (latest), in una cartella denominata Visual Studio 2022.

Nota

Diverse opzioni degli strumenti o degli strumenti da riga di comando possono richiedere l'autorizzazione Amministrazione istrator. Se si verificano problemi di autorizzazione quando vengono usati, è consigliabile aprire la finestra del prompt dei comandi per gli sviluppatori usando l'opzione Esegui come Amministrazione istrator. Fare clic con il pulsante destro del mouse per aprire il menu di scelta rapida per la finestra del prompt dei comandi, quindi scegliere Altro, Esegui come amministratore.

Per aprire una finestra del prompt dei comandi per sviluppatori

1. Sul desktop aprire il menu Start di Windows. In Windows 11 scegliere il pulsante Tutte le app per aprire l'elenco delle app installate. In Windows 10 l'elenco è aperto a sinistra. Scorrere verso il basso l'elenco per trovare e aprire la cartella (non l'app) per la versione di Visual Studio, ad esempio Visual Studio 2022.

2. Nella cartella scegliere il Prompt dei comandi per gli sviluppatori per la versione di Visual Studio in uso. Questo collegamento avvia una finestra del prompt dei comandi per gli sviluppatori che usa l'architettura di compilazione predefinita di strumenti nativi x86 a 32 bit per compilare codice nativo x86 a 32 bit. Se si preferisce un'architettura di compilazione non predefinita, scegliere uno dei prompt dei comandi degli strumenti nativi o incrociati per specificare l'architettura host e di destinazione.

Per un modo ancora più rapido per aprire un prompt dei comandi per gli sviluppatori, immettere il prompt dei comandi per gli sviluppatori nella casella di ricerca desktop. Scegliere quindi il risultato desiderato.

Nota

Per impostazione predefinita, la directory di lavoro corrente in un prompt dei comandi per sviluppatori è la radice dell'installazione di Visual Studio nella directory Programmi. Questa non è una posizione appropriata per il codice e i progetti. Modificare la directory di lavoro corrente in un'altra posizione prima di creare un progetto. L'IDE crea progetti nella directory utente, in genere in %U edizione Standard RPROFILE%\source\repos.

Percorsi dei file dei comandi per sviluppatori

Se si preferisce impostare l'ambiente di compilazione in una finestra del prompt dei comandi esistente, è possibile usare uno dei file di comando creati dal programma di installazione. È consigliabile impostare l'ambiente in una nuova finestra del prompt dei comandi. Non è consigliabile passare in un secondo momento agli ambienti nella stessa finestra di comando.

Il percorso del file di comando dipende dalla versione di Visual Studio installata e dalle scelte effettuate durante l'installazione. Per Visual Studio 2019, il percorso di installazione tipico in un sistema a 64 bit è in \Program Files\Microsoft Visual Studio\2022\<edition>. Può <edition> essere Community, Professional, Enterprise, BuildTools o un altro soprannome fornito.

Il file di comando del prompt dei comandi per gli sviluppatori primario, VsDevCmd.bat, si trova nella Common7\Tools sottodirectory . Quando non vengono specificati parametri, imposta l'ambiente in modo da usare gli strumenti nativi x86 per compilare codice x86 a 32 bit.

Sono disponibili altri file di comando per configurare architetture di compilazione specifiche. I file di comando disponibili dipendono dai carichi di lavoro e dalle opzioni di Visual Studio installati. In Visual Studio 2017 e Visual Studio 2019 sono disponibili nella sottodirectory VC\Auxiliary\Build.

Questi file di comando impostano i parametri predefiniti e chiamano VsDevCmd.bat per configurare l'ambiente di architettura di compilazione specificato. Un'installazione tipica può includere questi file di comando:

File di comando	Architetture host e di destinazione
vcvars32.bat	Usare gli strumenti nativi x86 a 32 bit per compilare codice x86 a 32 bit.
vcvars64.bat	Usare gli strumenti nativi x64 a 64 bit per compilare codice x64 a 64 bit.
vcvarsx86_amd64.bat	Usare gli strumenti nativi x86 a 32 bit per compilare codice x64 a 64 bit.
vcvarsamd64_x86.bat	Usare gli strumenti nativi x64 a 64 bit per compilare codice x86 a 32 bit.
vcvarsx86_arm.bat	Usare gli strumenti nativi x86 a 32 bit per compilare codice ARM.
vcvarsamd64_arm.bat	Usare gli strumenti nativi x64 a 64 bit per compilare codice ARM.
vcvarsx86_arm64.bat	Usare gli strumenti incrociati nativi x86 a 32 bit per compilare il codice ARM64.
vcvarsamd64_arm64.bat	Usare gli strumenti incrociati nativi x64 a 64 bit per compilare il codice ARM64.
vcvarsall.bat	Usare i parametri per specificare le architetture host e di destinazione, Windows SDK e le opzioni della piattaforma. Per un elenco di opzioni supportate, chiamare usando un /help parametro .

Attenzione

Il vcvarsall.bat file e altri file di comando di Visual Studio possono variare da computer a computer. Non sostituire un file mancante o danneggiato vcvarsall.bat utilizzando un file da un altro computer. Eseguire nuovamente il programma di installazione di Visual Studio per sostituire il file mancante.

Il vcvarsall.bat file varia anche dalla versione alla versione. Se la versione corrente di Visual Studio è installata in un computer con anche una versione precedente di Visual Studio, non eseguire vcvarsall.bat o un altro file di comando di Visual Studio da versioni diverse nella stessa finestra del prompt dei comandi.

Usare gli strumenti di sviluppo in una finestra di comando esistente

Il modo più semplice per specificare un'architettura di compilazione specifica in una finestra di comando esistente consiste nell'usare il vcvarsall.bat file. Usare vcvarsall.bat per impostare le variabili di ambiente per configurare la riga di comando per la compilazione nativa a 32 bit o a 64 bit. Gli argomenti consentono di specificare la compilazione incrociata ai processori x86, x64, ARM o ARM64. Puoi scegliere come destinazione microsoft Store, piattaforma UWP (Universal Windows Platform) o piattaforme desktop di Windows. È anche possibile specificare quale Windows SDK usare e selezionare la versione del set di strumenti della piattaforma.

Se usato senza argomenti, vcvarsall.bat configura le variabili di ambiente per l'uso del compilatore x86 nativo corrente per le destinazioni Desktop di Windows a 32 bit. È possibile aggiungere argomenti per configurare l'ambiente per l'uso di uno degli strumenti nativi o tra compilatori. vcvarsall.bat visualizza un messaggio di errore se si specifica una configurazione non installata o non disponibile nel computer.

Sintassi vcvarsall

vcvarsall.bat [architecture] [platform_type] [winsdk_version] [-vcvars_ver=vcversion] [spectre_mode]

architecture
Questo argomento facoltativo specifica l'architettura host e di destinazione da usare. Se l'architettura non è specificata, viene usato l'ambiente di compilazione predefinito. Sono supportati questi argomenti:

architecture	Compilatore	Architettura del computer host	Architettura dell'output di compilazione (destinazione)
x86	x86 nativo a 32 bit	x86, x64	x86
x86_amd64 oppure x86_x64	x64 su x86 (incrociato)	x86, x64	x64
x86_arm	ARM su x86 (incrociato)	x86, x64	ARM
x86_arm64	ARM64 su x86 (incrociato)	x86, x64	ARM64
amd64 oppure x64	x64 nativo a 64 bit	x64	x64
amd64_x86 oppure x64_x86	x86 su x64 (incrociato)	x64	x86
amd64_arm oppure x64_arm	ARM su x64 (incrociato)	x64	ARM
amd64_arm64 oppure x64_arm64	ARM64 su x64 (incrociato)	x64	ARM64

platform_type
Questo argomento facoltativo consente di specificare store o uwp come tipo di piattaforma. Per impostazione predefinita, l'ambiente è impostato per la compilazione di app desktop o console.

winsdk_version
Facoltativamente, specifica la versione di Windows SDK da usare. Per impostazione predefinita, viene usata la versione più recente di Windows SDK installata. Per specificare la versione di Windows SDK, è possibile usare un numero completo di Windows SDK, 10.0.10240.0ad esempio , o specificare 8.1 per usare Windows 8.1 SDK.

vcversion
Facoltativamente, specifica il set di strumenti del compilatore di Visual Studio da usare. Per impostazione predefinita, l'ambiente è impostato per l'uso del set di strumenti del compilatore di Visual Studio corrente.

Usare -vcvars_ver=14.2x.yyyyy per specificare una versione specifica del set di strumenti del compilatore di Visual Studio 2019.

Usare -vcvars_ver=14.29 per specificare la versione più recente del set di strumenti del compilatore di Visual Studio 2019.

Usare -vcvars_ver=14.0 per specificare il set di strumenti del compilatore di Visual Studio 2015.

spectre_mode
Lasciare questo parametro fuori per usare librerie senza mitigazioni Spectre. Usare il valore spectre per usare librerie con mitigazioni Spectre.

Per configurare l'ambiente di compilazione in una finestra del prompt dei comandi esistente

1. Al prompt dei comandi usare il comando CD per passare alla directory di installazione di Visual Studio. Quindi, usare nuovamente CD per passare alla sottodirectory contenente i file di comando specifici della configurazione. Per Visual Studio 2019 e Visual Studio 2017, usare la sottodirectory VC\Auxiliary\Build . Per Visual Studio 2015, usare la sottodirectory VC .

2. Immettere il comando per l'ambiente di sviluppo preferito. Ad esempio, per compilare il codice ARM per UWP in una piattaforma a 64 bit, usando il set di strumenti del compilatore windows SDK e Visual Studio più recente, usare questa riga di comando:

   vcvarsall.bat amd64_arm uwp

Creare un collegamento del prompt dei comandi personalizzato

Aprire la finestra di dialogo Proprietà per un collegamento al prompt dei comandi per gli sviluppatori per visualizzare la destinazione del comando usata. Ad esempio, la destinazione per il collegamento Prompt dei comandi degli strumenti nativi x64 per VS 2019 è simile a:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"

I file batch specifici dell'architettura impostano il architecture parametro e chiamano vcvarsall.bat. È possibile passare le stesse opzioni a questi file batch come si passerebbe a vcvarsall.batoppure è sufficiente chiamare vcvarsall.bat direttamente. Per specificare i parametri per il proprio collegamento del prompt dei comandi, aggiungerli alla fine del comando tra virgolette doppie. Ad esempio, ecco un collegamento per compilare il codice ARM per UWP in una piattaforma a 64 bit, usando la versione più recente di Windows SDK. Per usare un set di strumenti del compilatore precedente, specificare il numero di versione. Usare una destinazione del comando simile alla seguente nel collegamento:

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29

Modificare il percorso in modo da riflettere la directory di installazione di Visual Studio. Il file vcvarsall.bat contiene altre informazioni sui numeri di versione specifici.

Strumenti da riga di comando

Per compilare un progetto C/C++ al prompt dei comandi, Visual Studio offre questi strumenti da riga di comando:

CL
Usare il compilatore (cl.exe) per compilare e collegare file del codice sorgente in app, librerie e DLL.

Link
Usare il linker (link.exe) per collegare file oggetto e librerie compilati in app e DLL.

Quando si esegue la compilazione nella riga di comando, il comando F1 non è disponibile per la Guida immediata. È invece possibile usare un motore di ricerca per ottenere informazioni su avvisi, errori e messaggi. È anche possibile scaricare e usare i file della Guida offline. Per usare la ricerca in Microsoft Learn, immettere la query nella casella di ricerca nella parte superiore di qualsiasi articolo.

Strumenti di gestione dei progetti da riga di comando

Per impostazione predefinita, l'IDE di Visual Studio usa sistemi di compilazione di progetti nativi basati su MSBuild. È possibile richiamare MSBuild direttamente per compilare progetti senza usare l'IDE. È anche possibile usare il devenv comando per usare Visual Studio per compilare progetti e soluzioni. Visual Studio supporta anche sistemi di compilazione basati su CMake o NMake.

MSBuild
Usare MSBuild (msbuild.exe) e un file di progetto (vcxproj) per configurare una compilazione e richiamare il set di strumenti senza caricare l'IDE di Visual Studio. Equivale all'esecuzione del comando Compila progetto o Compila soluzione nell'IDE di Visual Studio. MSBuild presenta vantaggi rispetto all'IDE quando si esegue la compilazione nella riga di comando. Non è necessario installare l'IDE completo in tutti i server di compilazione e le pipeline di compilazione. Evitare il sovraccarico aggiuntivo dell'IDE. MSBuild viene eseguito in ambienti di compilazione in contenitori e supporta un logger binario.

DEVENV
Usare DEVENV (devenv.exe) combinato con un'opzione della riga di comando, /Build ad esempio o /Clean per eseguire determinati comandi di compilazione senza visualizzare l'IDE di Visual Studio.

CMake
CMake (cmake.exe) è uno strumento open source multipiattaforma per definire i processi di compilazione eseguiti su più piattaforme. CMake può configurare e controllare gli strumenti di compilazione nativi per le piattaforme supportate, ad esempio MSBuild e Make. Per altre informazioni su CMake, vedere la documentazione di CMake.

NMAKE
Usare NMAKE (nmake.exe) per compilare progetti C++ usando un makefile tradizionale.

Nota

A partire da Visual Studio 2019 versione 16.5, MSBuild e DEVENV non usano l'ambiente da riga di comando per controllare il set di strumenti e le librerie usate.

Contenuto della sezione

Questi articoli illustrano come compilare app nella riga di comando e descrivere come personalizzare l'ambiente di compilazione da riga di comando. Alcuni illustrano come usare set di strumenti a 64 bit e le piattaforme x86, x64, ARM e ARM64. Descrivono anche l'uso degli strumenti di compilazione da riga di comando MSBuild e NMAKE.

Procedura dettagliata: Compilazione di un programma C++ nativo nella riga di comando
Viene illustrato un esempio che illustra come creare e compilare un programma C++ nella riga di comando.

Procedura dettagliata: compilazione di un programma in C dalla riga di comando
Descrive come compilare un programma nel linguaggio di programmazione C.

Procedura dettagliata: Compilazione di un programma C++/CLI nella riga di comando
Descrive come creare e compilare un programma C++/CLI che usa .NET Framework.

Procedura dettagliata: Compilazione di un programma C++/CX nella riga di comando
Descrive come creare e compilare un programma C++/CX che usa Windows Runtime.

Riferimenti a NMAKE
Fornisce collegamenti ad articoli in cui viene descritta l'utilità Microsoft Program Maintenance Utility (NMAKE.EXE).

MSBuild dalla riga di comando - C++
Fornisce collegamenti ad articoli in cui vengono descritte le modalità di utilizzo di msbuild.exe dalla riga di comando.

Sezioni correlate

/MD, /MT, /LD (usare la libreria di runtime)
Descrive come usare queste opzioni del compilatore per l'utilizzo di una libreria di runtime di debug o di rilascio.

Opzioni del compilatore C/C++
Fornisce collegamenti ad articoli in cui vengono descritte le opzioni del compilatore C e C++ e fornite informazioni su CL.exe.

Opzioni del linker MSVC
Fornisce collegamenti ad articoli in cui vengono descritte le opzioni del linker e fornite informazioni su CL.exe.

Strumenti di compilazione aggiuntivi MSVC
Fornisce collegamenti agli strumenti di compilazione per C/C++ inclusi in Visual Studio.

Vedi anche

Progetti e sistemi di compilazione