Informationen zur Rechtschreibprüfung

Viele der Features in Visual Studio sind darauf ausgelegt, dass Ihr Code wie gewünscht funktioniert. Sie sorgen zum Beispiel dafür, dass dieser kompiliert werden kann, oder helfen Ihnen bei der Codeformatierung. Mit der neuen Rechtschreibprüfung, die in Version 17.5 in Visual Studio eingeführt wurde, sorgt Visual Studio sogar für eine korrekte Rechtschreibung.

Die Rechtschreibprüfung ist für jede C#-, C++- oder Markdowndatei verfügbar. Wenn die Rechtschreibprüfung aktiviert ist, markiert Visual Studio alle Wörter, die es als falsch geschriebene Wörter erkennt. Visual Studio schlägt auch alternative Schreibweisen vor und hilft bei der Korrektur. Das Feature nimmt sogar eine kontextbezogene Umbenennung vor, wenn Rechtschreibfehler in Bezeichnern vorkommen, damit Ihr Code trotzdem kompiliert wird.

Sie können die Rechtschreibprüfung deaktivieren oder aktivieren, indem Sie auf der Hauptsymbolleiste die Schaltfläche Rechtschreibprüfung umschalten oder auf der Menüleiste den Befehl Bearbeiten>Erweitert>Rechtschreibprüfung umschalten auswählen.

Verwendung

Wenn der Cursor sich auf einem Rechtschreibfehler befindet, enthalten die Schnellaktionen Korrekturoptionen für die Rechtschreibfehler. Sie können die Schnellaktionen mit der Tastenkombination STRG+. oder ALT+EINGABE aufrufen. Wenn das Kontextmenü erscheint, zeigt Visual Studio drei Optionen zur Korrektur eines Rechtschreibfehlers an.

Wenn eines der Wörterbücher Rechtschreibvorschläge enthält, zeigt Visual Studio diese an. Wenn mehrere Wörterbücher Vorschläge enthalten, gruppiert Visual Studio die Vorschläge nach Wörterbuch. Bei Zeichenfolgen und Kommentaren führt die Auswahl eines dieser Vorschläge zu einer einmaligen, direkten Ersetzung. Bei Bezeichnern in einem C++- oder C#-Dokument führt die Annahme eines Vorschlags zu einem Refactoring bzw. einer Umbenennung, die alle Instanzen des Bezeichners aktualisiert, damit der Code kompiliert werden kann.

Sie können Rechtschreibfehler auch ignorieren. Wenn Sie den Fehler ignorieren, erstellt Visual Studio eine Datei „exclusion.dic“ im AppData-Verzeichnis auf Ihrem lokalen Computer. Wenn Sie sich entschieden haben, ein Wort zu ignorieren, ignoriert die Rechtschreibprüfung es in allen Instanzen von Visual Studio.

Wie funktioniert dies?

Da in C#, C++ und Markdown englischsprachige Schlüsselwörter verwendet werden, verwendet Visual Studio in der Regel das Wörterbuch „Englisch (Vereinigte Staaten)“ oder „en-us“ für die Rechtschreibprüfung. Visual Studio überprüft die Windows-Instanz auf die verwendete Anzeigesprache, und wenn es sich nicht um „en-us“ handelt, wird auch dieses Wörterbuch verwendet.

Hinweis

In C# und C++ gibt es zudem zusätzliche Wörterbücher für Schlüsselwörter in diesen Sprachen, die verhindern, dass Wörter wie „Namespace“ oder „alloc“ als falsch geschriebene Wörter gekennzeichnet werden.

Aus dem Feedback der ersten Benutzer*innen dieses Features ging hervor, dass Entwickler*innen über Fehler im Dokument informiert werden möchten, mit dem sie gerade arbeiten. Als Reaktion auf dieses Feedback scannt die Rechtschreibprüfung nur die Dokumente, die im Editor aktiv sind. Als direkte Reaktion auf dieses Feedback überprüft die Rechtschreibprüfung nun geöffnete Dokumente.

In der folgenden Tabelle sind einige der Heuristiken aufgeführt, die die Rechtschreibprüfung beim Überprüfen eines Codedokuments anwendet:

Im Code	Von Visual Studio überprüft	Warum?
Hallo	Hello, hello	Es wird immer auf Eigennamen und gängige Substantive überprüft.
HelloWorld	Hello, hello, World, world	Binnenmajuskel kennzeichnen Wortgrenzen.
Hello.World	Hello, hello, World, world	Interpunktion kennzeichnet Wortgrenzen.
_Hello123	Hello, hello	Vorangestellte oder nachstehende Zahlen oder Satzzeichen werden entfernt.
Hello2World	Hello, hello, World, world	Zahlen in der Mitte kennzeichnen Wortgrenzen (genau wie Interpunktion).
btnWorld	World, world	Fragmente mit bis zu drei Zeichen werden ignoriert.
helloworld	Helloworld, helloworld	Es ist kein Hinweis auf Wortgrenzen vorhanden.

Wenn Visual Studio in einem der verwendeten Wörterbücher eine Übereinstimmung für das Token findet, wird das Token als akzeptabel angesehen, und die Überprüfung wird weiter ausgeführt. Andernfalls gilt das Token als falsch geschrieben, und Visual Studio kennzeichnet es als Rechtschreibfehler.

Anpassen der Rechtschreibprüfung

Sie können die Rechtschreibprüfung anpassen und für eine Zusammenarbeitsumgebung optimieren. Visual Studio verwendet eine EditorConfig-Datei für die Konfiguration, damit Sie das Verhalten der Rechtschreibprüfung in einem Repository steuern können.

Mit der Konfiguration einer EditorConfig-Datei können Sie die Programmierstandards festlegen, die von allen eingehalten werden sollen. Auf diese Weise können Sie eine Konsistenz erzielen, die mit anderen Methoden nur schwer erreichbar wäre.

Im Folgenden finden Sie einige Beispiele und Anwendungsfälle für die Optionen, die Sie in einer EditorConfig-Datei konfigurieren können:

• Listen Sie die Sprachen auf, die Visual Studio verwenden soll. In diesem Beispiel verwendet Visual Studio bei der Rechtschreibprüfung nur die Wörterbücher „en-us“ und „fr-fr“.

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

  Hinweis

  Installieren Sie das Language Pack für jede Sprache, die Sie verwenden möchten, damit Visual Studio keine Wörter fälschlicherweise als Rechtschreibfehler kennzeichnet.

• Legen Sie fest, was Visual Studio überprüfen soll. In diesem Beispiel überprüft Visual Studio Bezeichner und Kommentare auf falsch geschriebene Wörter, jedoch keine Zeichenfolgen.

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

• Legen Sie den Schweregrad fest, den Visual Studio Rechtschreibfehlern in der Fehlerliste zuweist. In diesem Beispiel werden Rechtschreibfehler als Fehler angezeigt.

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

• Erstellen Sie ein eigenes Ausschlusswörterbuch, um Wörter anzugeben, die Sie als richtig geschrieben betrachten. In diesem Beispiel sucht Visual Studio bei der ersten Ausführung der Rechtschreibprüfung für eine beliebige Datei in der Projektmappe nach einer „exclusion.dic“-Datei. Bei C#-Projekten wird im selben Verzeichnis wie die SLN-Datei gesucht, bei C++-Projekten im Stammverzeichnis. Wenn keine „exclusion.dic“-Datei vorhanden ist, erstellt Visual Studio eine. Wenn ein*e Benutzer*in dann ein Wort ignoriert, fügt Visual Studio es dieser „exclusion.dic“-Datei hinzu. Visual Studio betrachtet jedes Wort, das in dieser „exclusion.dic“-Datei enthalten ist, als richtig geschrieben.

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

  Hinweis

  Visual Studio verwendet das Ausschlusswörterbuch, das von der spelling_exclusion_path-Option in Ihrer EDITORCONFIG-Datei oder einer Datei „exclusion.dic“ in Ihrem Verzeichnis %localappdata%\Microsoft\VisualStudio\<Version> angegeben wird, wenn keine Option gefunden werden kann.

• Steuern Sie, ob das sprachspezifische Ausschlusswörterbuch so verwendet werden soll. Wenn dieser Wert auf false festgelegt ist, werden alle diejenigen Wörter nicht verwendet, die in den Ausschlusswörterbüchern für C++ oder C# angegeben sind. Der Standardwert ist „true“.

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

Behandlung von Sonderfällen

Es gibt einige besondere Verhaltensweisen, wie Visual Studio Code auf Rechtschreibfehler überprüft, die sich von einer herkömmlichen Rechtschreibprüfung unterscheiden, die für geschriebenen Text entwickelt wurde. Einige dieser Verhaltensweisen sind folgende:

• In einer Zeichenfolge, die Interpunktionszeichen enthält, z. B. „misc.“, schlägt Visual Studio keine Korrektur vor, da Interpunktion in einem Bezeichner zu Code führen kann, der nicht kompilierbar ist.
• Umgekehrte Schrägstriche in einer Zeichenfolge lassen die Rechtschreibprüfung des nachfolgenden Zeichens aus und behandeln den umgekehrten Schrägstrich und das nachfolgende Zeichen als Worttrennzeichen. Beispielsweise erkennt Visual Studio in der Zeichenfolge hello\nworldzuerst den umgekehrten Schrägstrich. Visual Studio behandelt das \n als Worttrennzeichen, das „hello“ und „world“ belässt, die jeweils einzeln überprüft werden.
• Zeichenfolgen, die URLs wie https://... oder mailto:.. enthalten, werden nicht für die gesamte Zeichenfolge auf Rechtschreibung geprüft.

Zugehöriger Inhalt

• Verbessern der Rechtschreibprüfung