Путь к исходному коду

Исходный путь указывает каталоги, в которых находятся исходные файлы C и C++.

Если выполняется отладка процесса в пользовательском режиме на компьютере, где был создан исполняемый файл, и исходные файлы по-прежнему находятся в исходном расположении, отладчик может автоматически найти исходные файлы.

В большинстве других ситуаций необходимо задать исходный путь или загрузить отдельные исходные файлы.

При выполнении удаленной отладки с помощью отладчика сервер отладки использует исходный путь. Если вы используете WinDbg в качестве отладчика, каждый клиент отладки также имеет собственный путь к локальному источнику. Все команды, связанные с исходным кодом, получают доступ к исходным файлам на локальном компьютере. Необходимо задать правильные пути на любом клиенте или сервере, на которых вы хотите использовать исходные команды.

Эта система с несколькими путями также позволяет клиенту отладки использовать команды, связанные с исходным кодом, не делясь исходными файлами с другими клиентами или сервером. Эта система полезна при наличии частных или конфиденциальных исходных файлов, к которым у одного из пользователей есть доступ.

Исходные файлы также можно загрузить в любое время, независимо от пути к источнику.

Синтаксис исходного пути

Исходный путь отладчика — это строка, состоящая из нескольких путей к каталогам, разделенных точкой с запятой.

Поддерживаются относительные пути. Однако если отладчик всегда не запускается из одного каталога, следует добавить букву диска или сетевую папку перед каждым путем. Также поддерживаются сетевые общие папки.

Примечание Если вы подключены к корпоративной сети, наиболее эффективным способом доступа к исходным файлам является использование исходного сервера. Исходный сервер можно использовать с помощью строки srv\* в исходном пути. Дополнительные сведения об исходных серверах см. в разделе Использование исходного сервера.

Управление исходным путем

Чтобы управлять исходным и локальным путем к источнику, можно выполнить одно из следующих действий.

• Перед запуском отладчика используйте переменную среды _NT_SOURCE_PATH, чтобы задать исходный путь. При попытке добавить недопустимый каталог с помощью этой переменной среды отладчик игнорирует этот каталог.

• При запуске отладчика используйте параметр командной строки-srcpath, чтобы задать исходный путь.

• Используйте команду .srcpath (Set Source Path) для отображения, задания, изменения или добавления к исходному пути. Если вы используете исходный сервер, SRCFIX (Использовать исходный сервер) немного проще.

• (Только WinDbg) Используйте команду .lsrcpath (Задать путь к локальному источнику), чтобы отобразить, задать, изменить или добавить к локальному исходному пути. Если вы используете исходный сервер, .lsrcfix (Use Local Source Server) немного проще. Вы также можете использовать Command-Line WinDbg с параметром -lscrpath. Дополнительные сведения см. в разделе Параметры Command-Line WinDbg.

• (Только WinDbg) Используйте [Файл | Команда Путь к исходному файлу или нажмите клавиши CTRL+P, чтобы отобразить, задать, изменить или добавить к исходному пути или локальному исходному пути.

Вы также можете напрямую открыть или закрыть исходный файл, выполнив одно из следующих действий:

• Используйте команду lsf (Загрузить или выгрузить исходный файл), чтобы открыть или закрыть исходный файл.

• (Только WinDbg) Используйте команду .open (Open Source File), чтобы открыть исходный файл.

• (Только WinDbg) Использование файла | открытый код команду file или нажмите клавиши CTRL+O, чтобы открыть исходный файл. Вы также можете использовать кнопку открытый код файла (ctrl+o) на панели инструментов.

  Примечание При использовании файла | Файл с открытым исходным кодом (или его контекстное меню или эквиваленты кнопок), чтобы открыть исходный файл, путь к нему автоматически добавляется в исходный путь.

• (Только WinDbg) Использование файла | Команда Recent Files позволяет открыть один из четырех исходных файлов, которые вы недавно открыли в WinDbg.

• (Только WinDbg) Использование файла | Команда Закрыть текущее окно или нажмите кнопку Закрыть в углу окна Источник , чтобы закрыть исходный файл.

См. также раздел

Дополнительные сведения об использовании исходных файлов см. в разделе Отладка в режиме исходного кода.