Share via

Creazione e modifica di un file EditorConfig personalizzato in Visual Studio per Mac

  • Articolo

Importante

Visual Studio per Mac è prevista per il ritiro il 31 agosto 2024 in conformità con Microsoft Criteri moderni relativi al ciclo di vita. Anche se è possibile continuare a usare Visual Studio per Mac, esistono diverse altre opzioni per gli sviluppatori in Mac, ad esempio la versione di anteprima della nuova estensione C# Dev Kit per VS Code.

Altre informazioni sulle sequenze temporali e sulle alternative di supporto.

In Visual Studio per Mac è possibile aggiungere un file EditorConfig al progetto o alla soluzione per imporre stili di codifica coerenti per tutti gli utenti che usano la codebase. Le impostazioni dichiarate nel file EditorConfig hanno la precedenza sulle impostazioni dell'editor di testo di Visual Studio per Mac globali. L'uso di un file EditorConfig all'interno del progetto o della codebase consente di impostare lo stile di scrittura del codice, le preferenze e gli avvisi per il progetto. Poiché il file fa parte della codebase, rende più semplice per tutti gli utenti rispettare le procedure di scrittura del codice per un progetto, indipendentemente dall'IDE o dall'editor di codice usato.

I file EditorConfig sono supportati in molti IDE e editor di codice, compreso Visual Studio.

Impostazioni supportate

L'editor in Visual Studio per Mac supporta il set di base delle proprietà di EditorConfig:

  • indent_style
  • indent_size
  • tab_width
  • end_of_line
  • charset
  • trim_trailing_whitespace
  • insert_final_newline
  • root

EditorConfig supporta anche convenzioni per la scrittura di codice in C#.

Aggiungere un file EditorConfig a un progetto

Aggiunta di un nuovo file EditorConfig

  1. Aprire il progetto in Visual Studio per Mac. Selezionare il nodo della soluzione o del progetto a cui si desidera aggiungere il file EditorConfig. L'aggiunta del file alla directory della soluzione consente di applicare le impostazioni di editorconfig a tutti i progetti nella soluzione.

  2. Fare clic con il pulsante destro del mouse sul nodo e scegliere Aggiungi nuovo file per aprire la finestra di dialogo Nuovo file>:

    Content menu items

  3. Scegliere Misc Empty Text File (File di testo vuoto misc>) e assegnargli il nome.editorconfig. Premere Nuovo per creare il file e aprirlo nell'editor:

    New file dialog

    Aggiungere automaticamente l'elemento a livello di soluzione consente di crearlo e annidarlo in una cartella Elementi di soluzione:

    Solution item displayed in Solution Window

  4. Modificare il file . Ad esempio:

    # This file is the top-most EditorConfig file
root = true

# All Files
[*]
indent_style = space
indent_size = 8
insert_final_newline = false
trim_trailing_whitespace = false

[*.cs]
csharp_new_line_before_open_brace = none

  5. Le impostazioni dal file .editorconfig verranno applicate a qualsiasi nuovo codice scritto, ma il codice esistente potrebbe dover essere riformattato per renderlo coerente con le nuove impostazioni. Per applicare le impostazioni dal .editorconfig file a un file di origine esistente, aprire il file e scegliere Modifica > formato > documento dalla barra dei menu:

    Format Document menu item

Aggiunta di un file EditorConfig esistente

Se si sta lavorando a un progetto o a una soluzione contenente già un file .editorconfig, per applicare le impostazioni non è necessaria alcuna operazione. Tutte le nuove righe di codice vengono formattate in base alle impostazioni del file EditorConfig.

Nel progetto è consigliabile riusare un file .editorconfig esistente. Per aggiungere un file esistente, eseguire le operazioni seguenti:

  1. Fare clic con il pulsante destro del mouse sulla cartella a cui si desidera aggiungerlo e selezionare Aggiungi > file.

  2. Passare alla directory del file richiesto.

  3. I file che iniziano con . (ad esempio .editorconfig) sono file nascosti in macOS, quindi premere Comando + Maiuscole + . per rendere il file .editorconfig visibile.

  4. Selezionare il file .editorconfig e fare clic su Apri:

    adding a new file window

  5. Quando viene visualizzata la finestra di dialogo seguente, selezionare l'opzione Copia file nella directory e selezionare OK:

    Add file to folder dialog options

Aggiornare le impostazioni dal file EditorConfig

Dopo aver aggiunto un file EditorConfig alla codebase, qualsiasi nuovo codice aggiunto viene formattato automaticamente in base alle impostazioni specificate. Il codice esistente non rispecchia automaticamente le impostazioni a meno che non si formatti la codebase.

Per riflettere le impostazioni del .editorconfig file, selezionare il nodo della soluzione e scegliere Modifica > formato > documento dalla barra dei menu:

Format document from the menu bar

Modifica di un file EditorConfig

Per specificare le impostazioni, i file EditorConfig usano un layout di file semplice, descritto di seguito tramite un esempio precedente:

# This file is the top-most EditorConfig file
root = true

# All Files
[*]
indent_style = space
indent_size = 4
insert_final_newline = false
trim_trailing_whitespace = false

[*.cs]
csharp_new_line_before_open_brace = none

Se si imposta root su true, il file viene contrassegnato come file di livello più alto della codebase e qualsiasi altro file .editorconfig di livello superiore nel progetto viene ignorato, come spiegato nella sezione Eseguire l'override delle impostazioni di EditorConfig.

Ogni sezione, identificata da parentesi quadre ([ ]), specifica le informazioni sui tipi di file interessati dalle proprietà che seguono.

Nell'esempio precedente, alcune impostazioni vengono applicate a tutti i file del progetto e altre vengono aggiunte solo ai file C#. Gli screenshot riportati di seguito illustrano la situazione prima e dopo l'applicazione delle impostazioni di .editorconfig:

Prima:

Before editorconfig settings have been applied

Dopo:

after editorconfig settings have been applied

Per altre informazioni sulle impostazioni di EditorConfig disponibili, vedere l'articolo Impostazioni delle convenzioni per la scrittura del codice .NET per EditorConfig e la sezione Supported Properties (Proprietà supportate) nella documentazione ufficiale.

Eseguire l'override delle impostazioni di EditorConfig

Per ogni soluzione è possibile avere più file .editorconfig. Visual Studio per Mac legge i file .editorconfig dall'alto verso il basso nella soluzione, aggiungendo ed eseguendo l'override delle impostazioni man mano. Questo significa che le impostazioni nel file .editorconfigpiù vicine al file in corso di modifica avranno la precedenza. Le impostazioni vengono recuperate dal file .editorconfig nella stessa cartella (se presente), poi dal file .editorconfig nella cartella padre (se presente) e così via finché non si raggiunge root=true.

Per assicurarsi che nessuna impostazione di alcun file .editorconfig di livello superiore sia applicata a questa parte della codebase, aggiungere la proprietà root=true all'inizio del file .editorconfig di livello inferiore:

# top-most EditorConfig file
root = true

Vedi anche