Freigeben über

Quellcodepfad

  • Artikel

Der Quellpfad gibt die Verzeichnisse an, in denen sich die C- und C++-Quelldateien befinden.

Wenn Sie einen Benutzermodusprozess auf dem Computer debuggen, auf dem die ausführbare Datei erstellt wurde, und wenn sich die Quelldateien noch am ursprünglichen Speicherort befinden, kann der Debugger die Quelldateien automatisch suchen.

In den meisten anderen Situationen müssen Sie den Quellpfad festlegen oder die einzelnen Quelldateien laden.

Wenn Sie das Remotedebuggen über den Debugger ausführen, verwendet der Debugserver den Quellpfad. Wenn Sie WinDbg als Debugger verwenden, verfügt jeder Debugclient auch über einen eigenen lokalen Quellpfad. Alle quellbezogenen Befehle greifen auf die Quelldateien auf dem lokalen Computer zu. Sie müssen die richtigen Pfade auf allen Clients oder Servern festlegen, die Sie quellbefehle verwenden möchten.

Dieses System mit mehreren Pfaden ermöglicht es einem Debugclient auch, quellbezogene Befehle zu verwenden, ohne die Quelldateien tatsächlich mit anderen Clients oder dem Server zu teilen. Dieses System ist nützlich, wenn private oder vertrauliche Quelldateien vorhanden sind, auf die einer der Benutzer Zugriff hat.

Sie können Quelldateien auch jederzeit laden, unabhängig vom Quellpfad.

Quellpfadsyntax

Der Quellpfad des Debuggers ist eine Zeichenfolge, die aus mehreren Verzeichnispfaden besteht, die durch Semikolons getrennt sind.

Relative Pfade werden unterstützt. Wenn Sie den Debugger jedoch nicht immer aus demselben Verzeichnis starten, sollten Sie vor jedem Pfad einen Laufwerkbuchstaben oder eine Netzwerkfreigabe hinzufügen. Netzwerkfreigaben werden ebenfalls unterstützt.

Hinweis Wenn Sie mit einem Unternehmensnetzwerk verbunden sind, ist die Verwendung eines Quellservers die effizienteste Methode für den Zugriff auf Quelldateien. Sie können einen Quellserver verwenden, indem Sie die srv\*-Zeichenfolge in Ihrem Quellpfad verwenden. Weitere Informationen zu Quellservern finden Sie unter Verwenden eines Quellservers.

Steuern des Quellpfads

Um den Quellpfad und den lokalen Quellpfad zu steuern, können Sie eine der folgenden Aktionen ausführen:

  • Verwenden Sie vor dem Starten des Debuggers die Umgebungsvariable _NT_SOURCE_PATH, um den Quellpfad festzulegen. Wenn Sie versuchen, über diese Umgebungsvariable ein ungültiges Verzeichnis hinzuzufügen, ignoriert der Debugger dieses Verzeichnis.

  • Wenn Sie den Debugger starten, verwenden Sie die Befehlszeilenoption -srcpath, um den Quellpfad festzulegen.

  • Verwenden Sie den Befehl .srcpath (Quellpfad festlegen), um den Quellpfad anzuzeigen, festzulegen, zu ändern oder anzufügen. Wenn Sie einen Quellserver verwenden, ist .srcfix (Quellserver verwenden) etwas einfacher.

  • (Nur WinDbg) Verwenden Sie den Befehl .lsrcpath (Set Local Source Path), um den lokalen Quellpfad anzuzeigen, festzulegen, zu ändern oder anzufügen. Wenn Sie einen Quellserver verwenden, ist .lsrcfix (Verwenden des lokalen Quellservers) etwas einfacher. Sie können auch die WinDbg-Command-Line mit dem Parameter -lscrpath verwenden. Weitere Informationen finden Sie unter WinDbg Command-Line-Optionen.

  • (Nur WinDbg) Verwenden der [Datei | Befehl Quelldateipfad , oder drücken Sie STRG+P, um den Quellpfad oder den lokalen Quellpfad anzuzeigen, festzulegen, zu ändern oder anzufügen.

Sie können eine Quelldatei auch direkt öffnen oder schließen, indem Sie eine der folgenden Aktionen ausführen:

  • Verwenden Sie den Befehl lsf (Quelldatei laden oder entladen), um eine Quelldatei zu öffnen oder zu schließen.

  • (Nur WinDbg) Verwenden Sie den Befehl .open (Open Source File), um eine Quelldatei zu öffnen.

  • (Nur WinDbg) Verwenden der Datei | Open Source Dateibefehl, oder drücken Sie STRG+o, um eine Quelldatei zu öffnen. Sie können auch die Schaltfläche Open Source Datei (STRG+o) auf der Symbolleiste verwenden.

    Hinweis Bei Verwendung von Datei | Öffnen Sie die Quelldatei (oder deren Kontextmenü oder Schaltflächenäquivalente), um eine Quelldatei zu öffnen. Der Pfad dieser Datei wird automatisch an den Quellpfad angefügt.

  • (Nur WinDbg) Verwenden der Datei | Befehl "Zuletzt verwendete Dateien ", um eine der vier Quelldateien zu öffnen, die Sie zuletzt in WinDbg geöffnet haben.

  • (Nur WinDbg) Verwenden der Datei | Schließen Sie den Befehl Aktuelles Fenster, oder wählen Sie in der Ecke des Quellfensters die Schaltfläche Schließen aus, um eine Quelldatei zu schließen.

Weitere Informationen

Weitere Informationen zur Verwendung von Quelldateien finden Sie unter Debuggen im Quellmodus.