Condividi tramite

Informazioni sul correttore ortografico

  • Articolo

Molte delle funzionalità di Visual Studio sono progettate per facilitare la scrittura del codice desiderato, assicurandosi che il codice venga compilato per semplificare lo stile del codice. Ora, con la funzionalità Controllo ortografico, introdotta nella versione 17.5, Visual Studio può anche assicurarsi che l'ortografia sia accurata.

Screenshot di un esempio dell'azione Controllo ortografico.

Il correttore ortografico è disponibile per qualsiasi file C#, C++o Markdown. Quando il correttore ortografico è abilitato, Visual Studio contrassegna tutte le parole rilevate come parole con errori di ortografia. Visual Studio suggerisce anche ortografie alternative e consente di correggerle. La funzionalità esegue anche una ridenominazione contestuale quando questi errori di ortografia sono identificatori in modo che il codice continui a essere compilato.

È possibile disattivare o attivare il correttore ortografico usando il pulsante Attiva/Disattiva controllo ortografico sulla barra degli strumenti principale oppure selezionando Modifica>controllo ortografico avanzato> dalla barra dei menu.

Come si usa?

Quando il cursore si trova in un errore ortografico, le azioni rapide forniscono soluzioni per correggere gli errori di ortografia. È possibile visualizzare le azioni rapide usando i tasti di scelta rapida CTRL+ o ALT+INVIO. Quando viene visualizzato il menu di scelta rapida, Visual Studio visualizza tre opzioni per gestire un problema di ortografia.

Se uno dei dizionari fornisce suggerimenti ortografici, Visual Studio li visualizza. Se più dizionari forniscono suggerimenti, Visual Studio raggruppa i suggerimenti in base al dizionario. Per le stringhe e i commenti, la scelta di uno di questi suggerimenti comporta una sola sostituzione sul posto. Per gli identificatori in un documento C++ o C#, l'accettazione di un suggerimento comporta un refactoring/ridenominazione che aggiorna tutte le istanze dell'identificatore per assicurarsi che il codice venga compilato.

Screenshot del correttore ortografico con più dizionari elencati.

È anche possibile scegliere di ignorare il problema di ortografia. Scegliendo di ignorare il problema, Visual Studio crea un file exclusion.dic nella directory AppData nel computer locale. Dopo aver scelto di ignorare una parola, il correttore ortografico lo ignora in tutte le istanze di Visual Studio.

Come funziona?

Poiché C#, C++e Markdown usano tutti l'inglese come lingua per le relative parole chiave, Visual Studio usa in genere il dizionario "Inglese (Stati Uniti)" o "en-us" per il controllo ortografico. Visual Studio controlla l'istanza di Windows per la lingua di visualizzazione in uso e, se non è "en-us", usa anche tale dizionario.

Nota

C# e C++ hanno anche dizionari aggiuntivi per le parole chiave in tali linguaggi, che impediscono che parole come "spazio dei nomi" o "alloc" vengano contrassegnate come parole con errori di ortografia.

Il feedback dei primi utenti di questa funzionalità ci ha informato che gli sviluppatori vogliono sapere solo degli errori nel documento con cui stanno lavorando. In risposta a tale feedback, il correttore ortografico analizza solo i documenti attivi nell'editor. In risposta diretta a questo feedback, il correttore ortografico analizza i documenti aperti.

La tabella seguente illustra alcune delle euristiche esaminate dal correttore ortografico durante l'analisi di un documento di codice:

Contenuto del codice Controlli di Visual Studio Perché?
Buongiorno Ciao, ciao Controllare sempre sia i sostantivi appropriati che i sostantivi comuni
HelloWorld Hello, hello, World, world Le maiuscole mediali vengono usate per contrassegnare i limiti delle parole
Hello.World Hello, hello, World, world La punteggiatura viene usata come limite di parola
_Hello123 Ciao, ciao Numeri iniziali o finali o segni di punteggiatura vengono rimossi
Hello2World Hello, hello, World, world I numeri mediali, come i segni di punteggiatura, vengono usati come limite di parola
btnWorld Mondo, mondo I frammenti di tre caratteri o meno vengono ignorati
helloworld Helloworld, helloworld Nessun indicatore per identificare i limiti delle parole

Se Visual Studio trova una corrispondenza per il token in uno dei dizionari in uso, il token viene considerato accettabile e l'analisi continua. In caso contrario, il token viene considerato errato e Visual Studio lo contrassegna come errore ortografico.

Screenshot di un esempio di errori ortografici nell'elenco errori.

Come personalizzare il correttore ortografico

È possibile personalizzare il correttore ortografico in modo che sia ottimizzato per un ambiente collaborativo. Di conseguenza, Visual Studio usa un file EditorConfig per la configurazione in modo da poter controllare il comportamento del correttore ortografico in un repository.

Configurando un file EditorConfig, è possibile stabilire gli standard di codifica che si prevede che tutti gli utenti seguano, in modo da mantenere una coerenza di codifica che potrebbe essere difficile tramite altri metodi.

Ecco alcuni esempi e scenari di casi d'uso delle opzioni che è possibile configurare in un file EditorConfig:

  • Elencare le lingue da usare per Visual Studio. In questo esempio Visual Studio usa solo i dizionari "en-us" e "fr-fr" durante il controllo dei problemi di ortografia.

    spelling_languages = _language_[,_language_]
    (Example: = en-us,fr-fr)

    Nota

    Assicurarsi di installare il Language Pack per qualsiasi lingua in uso per impedire a Visual Studio di contrassegnare erroneamente le parole come errori di ortografia.

  • Controllare il controllo di Visual Studio. In questo esempio Visual Studio controlla gli identificatori e i commenti per individuare parole con errori di ortografia, ma non controllano all'interno di stringhe.

    spelling_checkable_types = strings,identifiers,comments
    (Example: = identifiers,comments)

  • Controllare la gravità assegnata da Visual Studio agli errori ortografici nell'elenco degli errori. In questo esempio gli errori ortografici vengono visualizzati come errori.

    spelling_error_severity = error OR warning OR information OR hint
    (Example: = error)

  • Creare un dizionario di esclusione personalizzato per specificare le parole che si considerano digitate correttamente. In questo esempio, la prima volta che il correttore ortografico viene eseguito su qualsiasi file nella soluzione, Visual Studio verifica la presenza di un file exclusion.dic nella stessa directory del file .sln (per un progetto C#) o nella directory radice (per una directory C++). Se non esiste alcun file exclusion.dic, visual Studio ne crea uno. Quindi, ogni volta che l'utente sceglie di ignorare una parola, Visual Studio lo aggiunge a questo file exclusion.dic. Visual Studio considera qualsiasi parola visualizzata in questo file exclusion.dic come parola digitata correttamente.

    spelling_exclusion_path = absolute OR relative path to exclusion dictionary
    (Example: = .\exclusion.dic)

    Nota

    Visual Studio usa il dizionario di esclusione specificato dall'opzione spelling_exclusion_path nel file con estensione editorconfig o in un file exclusion.dic nella %localappdata%\Microsoft\VisualStudio\<Version> directory se non è possibile trovare un'opzione.

  • Controllare se il dizionario di esclusione specifico della lingua viene usato. Se impostato su false, le parole specificate nei dizionari di esclusione specifiche di C++ o C# non verranno usate. Il valore predefinito è true.

    spelling_use_default_exclusion_dictionary = true OR false
    (Example: = spelling_use_default_exclusion_dictionary = false)

Gestione dei casi speciali

Esistono alcuni comportamenti speciali nel modo in cui Visual Studio controlla il codice per verificare la presenza di errori ortografici diversi da un tradizionale correttore ortografico progettato per il testo scritto. Alcuni di questi comportamenti includono:

  • In una stringa che include punteggiatura, ad esempio "misc.", Visual Studio non suggerisce una correzione perché la punteggiatura in un identificatore potrebbe generare codice che non verrà compilato.
  • Le barre rovesciate in una stringa ometteranno il carattere successivo dal controllo ortografico e tratteranno la barra rovesciata e il carattere successivo come delimitatore di parola. Ad esempio, nella stringa hello\nworld, Visual Studio rileva prima la barra rovesciata. Visual Studio considera l'oggetto \n come delimitatore di parole, che lascia "hello" e "world", ognuno dei quali viene controllato singolarmente.
  • Le stringhe che contengono URL, ad https://... esempio o mailto:.. non verranno controllate in modo ortografico sull'intera stringa.

Contenuto correlato