Usare gli strumenti di compilazione Microsoft C++ dalla riga di comando

È possibile compilare applicazioni C e C++ nella riga di comando usando gli strumenti inclusi in Visual Studio. È anche possibile scaricare gli strumenti di compilazione Microsoft C++ (MSVC) come pacchetto autonomo. Non è necessario installare il IDE di Visual Studio se non si prevede di usarlo.

Scaricare e installare gli strumenti

Come usare gli strumenti da riga di comando

Quando si sceglie uno dei carichi di lavoro C++ nel programma di installazione di Visual Studio, viene installata una versione specifica del pacchetto MSVC Build Tools per impostazione predefinita. Per Visual Studio 2022 e versioni precedenti, il pacchetto è organizzato da un set di strumenti piattaforma (formato versione v###) che include tutti gli strumenti C e C++ per una versione specifica di Visual Studio. Per le versioni successive di Visual Studio, il pacchetto è costituito dalla versione MSVC (v##.## version format), che include tutti gli strumenti C e C++ per quel particolare pacchetto MSVC. La versione MSVC è disaccoppiata dalla versione Visual Studio.

Gli strumenti includono i compilatori C/C++, i linker, gli assembler e altri strumenti di compilazione. Include librerie e file header corrispondenti. È possibile usare tutti questi strumenti dalla riga di comando. Il IDE di Visual Studio li usa internamente. Sono disponibili compilatori e strumenti distinti per ambienti host x86 e x64, che creano 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. Queste variabili aggiungono gli strumenti al percorso e impostano 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 una specifica architettura di compilazione dell'host e di destinazione, la versione SDK di Windows e il toolset della piattaforma.

Per praticità, il programma di installazione crea anche collegamenti nel menu Start. Le scorciatoie aprono le finestre del Prompt dei comandi per sviluppatori utilizzando questi file di comando per combinazioni specifiche di host e piattaforma di destinazione. Questi collegamenti assicurano che tutte le variabili di ambiente necessarie siano impostate e pronte per essere utilizzate.

Le variabili di ambiente necessarie sono specifiche per l'installazione e per l'architettura di compilazione scelta. Gli aggiornamenti o gli upgrade del prodotto possono modificare le variabili. 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 aggiunti dal programma di installazione 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 in 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 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 LIBPATH . Usano anche altre variabili di ambiente specifiche per gli strumenti, le piattaforme e gli SDK installati. Anche una semplice installazione 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 dai tasti di scelta rapida del prompt dei comandi per gli sviluppatori, usare il SET comando . Apri una semplice finestra del Prompt dei comandi e acquisisci l'output del comando SET come riferimento iniziale. Aprire una finestra del Prompt dei comandi per sviluppatori e acquisire l'output del comando SET per il 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 Windows. Ecco un elenco delle scorciatoie del prompt dei comandi di base e delle architetture di build 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 incrociati 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 incrociati x64_x86. Imposta l'ambiente per l'uso di strumenti nativi x64 a 64 bit per compilare codice nativo x86 a 32 bit.

Per aprire una finestra del prompt dei comandi per gli sviluppatori

1. Sul desktop aprire il menu Windows Start. In Windows 11 scegliere 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 Developer per la versione di Visual Studio. Questo collegamento avvia una finestra del prompt dei comandi per 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 nativi o tra strumenti 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.

Percorsi dei file di comando 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 file di comando del prompt dei comandi per gli sviluppatori primario, VsDevCmd.bat, si trova nella Common7\Tools directory . Quando non si specificano parametri, imposta l'ambiente in modo da usare gli strumenti nativi x86 per compilare codice x86 a 32 bit x86.

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:

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 finestra del prompt dei comandi 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. È possibile specificare come destinazione Microsoft Store, piattaforma UWP (Universal Windows Platform) o piattaforme desktop Windows. È anche possibile specificare il Windows SDK da usare e selezionare la versione del set di strumenti della piattaforma.

Quando si usa vcvarsall.bat senza argomenti, configura le variabili di ambiente in modo da usare il compilatore nativo x86 corrente per le destinazioni desktop Windows a 32 bit. Aggiungi argomenti per configurare l'ambiente in modo da utilizzare uno qualsiasi degli strumenti di compilazione nativi o cross. vcvarsall.bat visualizza un messaggio di errore se si specifica una configurazione non installata o non è disponibile nel computer.

Sintassi vcvarsall

vcvarsall.bat[] [architectureplatform_type] [winsdk_version] [] [-vcvars_ver=vcversion] [spectre_mode]

• architecture

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

  architecture	Compilatore	Architettura del computer host	Architettura di destinazione dell'output di compilazione
  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	BRACCIO
  x86_arm64	ARM64 su x86 (cross-compilazione)	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 (compatibilità incrociata)	x64	BRACCIO
  amd64_arm64 oppure x64_arm64	ARM64 su x64 (incrociato)	x64	ARM64

• platform_type

  Questo argomento facoltativo specifica 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. Per specificare la versione Windows SDK, usare un numero SDK completo Windows, ad esempio 10.0.10240.0 o specificare 8.1 per usare Windows 8.1 SDK.

• vcversion

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

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

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

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

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

  Usare -vcvars_ver=14.0 per specificare il set di strumenti del compilatore 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 già aperta

1. Al prompt dei comandi usare il comando CD per passare alla directory di installazione Visual Studio. Usare CD quindi di nuovo per passare alla sottodirectory che contiene 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 codice ARM per UWP in una piattaforma a 64 bit, usando l'SDK di Windows più recente e Visual Studio set di strumenti del compilatore, usare questo comando:

   vcvarsall.bat amd64_arm uwp
   

Crea un collegamento personalizzato del prompt dei comandi

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64

I file batch specifici dell'architettura impostano il architecture parametro e chiamano vcvarsall.bat. È possibile passare le stesse opzioni a questi file batch quando si passa a vcvarsall.batoppure è sufficiente chiamare vcvarsall.bat direttamente. Per specificare i parametri per la tua scorciatoia da comando personalizzata, aggiungili alla fine del comando racchiusi 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. Usa un comando come questo come destinazione del collegamento:

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

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

%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0

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

Strumenti da riga di comando

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

• CL

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

• Link

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

Quando compili dalla riga di comando, il comando F1 non è disponibile per l'assistenza 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, il 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 comando devenv 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 il IDE di Visual Studio. Equivale a eseguire il progetto Build o Build Solution nel 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. Eviti 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, ad esempio /Build o /Clean per eseguire determinati comandi di compilazione senza visualizzare il 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.

Vedi anche

• Procedura dettagliata: Compilazione di un programma C++ nativo nella riga di comando
• Procedura dettagliata: compilazione di un programma in C dalla riga di comando
• Procedura dettagliata: Compilazione di un programma C++/CLI nella riga di comando
• Procedura dettagliata: Compilazione di un programma C++/CX nella riga di comando
• Progetti e sistemi di compilazione
• /MD, /MT, /LD (usare la libreria di runtime)
• Opzioni del compilatore C/C++
• Opzioni del linker MSVC
• Strumenti di compilazione aggiuntivi MSVC