dotnet format

Questo articolo si applica a: ✔️ .NET Core 6 SDK e versioni successive

Nome

dotnet format: formatta il codice in modo che corrisponda alle impostazioni di editorconfig.

Riepilogo

dotnet format [<PROJECT | SOLUTION>] [command] [options]

dotnet format -h|--help

Descrizione

dotnet format è un formattatore di codice che applica le preferenze di stile a un progetto o a una soluzione. Le preferenze verranno lette da un file .editorconfig, se presente, altrimenti verrà usato un set predefinito di preferenze. Per altre informazioni, vedere la documentazione di EditorConfig.

Argomenti

PROJECT | SOLUTION

Progetto o soluzione MSBuild in cui eseguire la formattazione del codice. Se non viene specificato alcun file di progetto o di soluzione, MSBuild cercherà nella directory di lavoro corrente un file con estensione proj o sln e userà questo file.

Opzioni

Nessuna delle opzioni seguenti è necessaria affinché il comando dotnet format abbia esito positivo, ma è possibile usarle per personalizzare ulteriormente ciò che viene formattato e in base a quali regole.

• --diagnostics <DIAGNOSTICS>

  Elenco di ID di diagnostica separati da spazi da usare come filtro per la correzione dello stile del codice o di problemi di terze parti. Il valore predefinito corrisponde agli ID elencati nel file .editorconfig. Per un elenco degli ID regola dell'analizzatore predefinito che è possibile specificare, vedere l'elenco degli ID per le regole di stile di analisi del codice.

• --severity

  Gravità minima della diagnostica da correggere. I valori consentiti sono info, warn e error. Il valore predefinito è warn.

• --no-restore

  Non esegue un ripristino implicito prima della formattazione. L'impostazione predefinita consiste nell'eseguire il ripristino implicito.

• --verify-no-changes

  Verifica che non vengano eseguite modifiche di formattazione. Termina con un codice di uscita diverso da zero in presenza di file formattati.

• --include <INCLUDE>

  Elenco separato da spazi di percorsi relativi di file o cartelle da includere dalla formattazione. Il valore predefinito è tutti i file nella soluzione o nel progetto.

• --exclude <EXCLUDE>

  Elenco separato da spazi di percorsi relativi di file o cartelle da escludere dalla formattazione. Il valore predefinito è Nessuno.

• --include-generated

  Formatta i file generati dall'SDK.

• -v|--verbosity <LEVEL>

  Imposta il livello di dettaglio. I valori consentiti sono q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic]. Il valore predefinito è m[inimal].

• --binarylog <BINARY-LOG-PATH>

  Registra tutte le informazioni di caricamento del progetto o della soluzione in un file di log binario.

• --report <REPORT-PATH>

  Produce un report JSON nella directory specificata da <REPORT_PATH>.

• -h|--help

  Mostra informazioni sulla Guida e sull'utilizzo

Sottocomandi

Spazio vuoto

dotnet format whitespace: formatta il codice in modo che corrisponda alle impostazioni di editorconfig per gli spazi vuoti.

Descrizione

Il dotnet format whitespace sottocomando esegue solo regole di formattazione associate alla formattazione degli spazi vuoti. Per un elenco completo delle possibili opzioni di formattazione che è possibile specificare nel file .editorconfig, vedere le opzioni di formattazione C#.

Opzioni

• --folder

  Considerare l'argomento <PROJECT | SOLUTION> come percorso di una semplice cartella di file di codice.

Style

dotnet format style: formatta il codice in modo che corrisponda alle impostazioni di EditorConfig per lo stile del codice.

Descrizione

Il dotnet format style sottocomando esegue solo regole di formattazione associate alla formattazione dello stile del codice. Per un elenco completo delle opzioni di formattazione che è possibile specificare nel file editorconfig, vedere Regole di stile del codice.

Opzioni

• --diagnostics <DIAGNOSTICS>

  Elenco di ID di diagnostica separati da spazi da usare come filtro per la correzione dello stile del codice o di problemi di terze parti. Il valore predefinito corrisponde agli ID elencati nel file .editorconfig. Per un elenco degli ID regola dell'analizzatore predefinito che è possibile specificare, vedere l'elenco degli ID per le regole di stile di analisi del codice.

• --severity

  Gravità minima della diagnostica da correggere. I valori consentiti sono info, warn e error. Il valore predefinito è warn.

Analizzatori

dotnet format analyzers: formatta il codice in modo che corrisponda alle impostazioni di editorconfig per gli analizzatori.

Descrizione

Il dotnet format analyzers sottocomando esegue solo regole di formattazione associate agli analizzatori. Per un elenco delle regole dell'analizzatore che è possibile specificare nel file editorconfig, vedere Regole di stile del codice.

Opzioni

• --diagnostics <DIAGNOSTICS>

  Elenco di ID di diagnostica separati da spazi da usare come filtro per la correzione dello stile del codice o di problemi di terze parti. Il valore predefinito corrisponde agli ID elencati nel file .editorconfig. Per un elenco degli ID regola dell'analizzatore predefinito che è possibile specificare, vedere l'elenco degli ID per le regole di stile di analisi del codice.

• --severity

  Gravità minima della diagnostica da correggere. I valori consentiti sono info, warn e error. Il valore predefinito è warn.

Esempi

• Formattare tutto il codice nella soluzione:

  dotnet format ./solution.sln
  

• Cancellare tutto il codice nel progetto dell'applicazione:

  dotnet format ./src/application.csproj
  

• Verificare che tutto il codice sia formattato correttamente:

  dotnet format --verify-no-changes
  

• Pulire tutto il codice nella directory src e test, ma non in src/submodule-a:

  dotnet format --include ./src/ ./tests/ --exclude ./src/submodule-a/