Partilhar via


Caminho do código-fonte

O caminho de origem especifica os diretórios em que os arquivos de origem C e C++ estão localizados.

Se você estiver depurando um processo de modo de usuário no computador em que o arquivo executável foi criado e se os arquivos de origem ainda estiverem em seu local original, o depurador poderá localizar automaticamente os arquivos de origem.

Na maioria das outras situações, você precisa definir o caminho de origem ou carregar os arquivos de origem individuais.

Quando você está executando a depuração remota por meio do depurador, o servidor de depuração usa o caminho de origem. Se você estiver usando o WinDbg como depurador, cada cliente de depuração também terá seu próprio caminho de origem local. Todos os comandos relacionados à origem acessam os arquivos de origem no computador local. Você precisa definir os caminhos adequados em qualquer cliente ou servidor que deseja usar comandos de origem.

Esse sistema de vários caminhos também permite que um cliente de depuração use comandos relacionados à origem sem realmente compartilhar os arquivos de origem com outros clientes ou com o servidor. Esse sistema será útil se houver arquivos de origem privados ou confidenciais aos quais um dos usuários tem acesso.

Você também pode carregar arquivos de origem a qualquer momento, independentemente do caminho de origem.

Sintaxe do caminho de origem

O caminho de origem do depurador é uma cadeia de caracteres que consiste em vários caminhos de diretório, separados por ponto e vírgula.

Caminhos relativos são compatíveis. No entanto, a menos que você sempre inicie o depurador do mesmo diretório, você deve adicionar uma letra da unidade ou um compartilhamento de rede antes de cada caminho. Também há suporte para compartilhamentos de rede.

Nota Se você estiver conectado a uma rede corporativa, a maneira mais eficiente de acessar arquivos de origem é usar um servidor de origem. Você pode usar um servidor de origem usando a cadeia de caracteres srv\* no caminho de origem. Para obter mais informações sobre servidores de origem, consulte Usando um servidor de origem.

Controlando o caminho de origem

Para controlar o caminho de origem e o caminho de origem local, você pode fazer um dos seguintes procedimentos:

  • Antes de iniciar o depurador, use a variável de ambiente _NT_SOURCE_PATH para definir o caminho de origem. Se você tentar adicionar um diretório inválido por meio dessa variável de ambiente, o depurador ignorará esse diretório.

  • Ao iniciar o depurador, use a opção de linha de comando-srcpath para definir o caminho de origem.

  • Use o comando .srcpath (Definir Caminho de Origem) para exibir, definir, alterar ou acrescentar ao caminho de origem. Se você estiver usando um servidor de origem, o .srcfix (Usar Servidor de Origem) será um pouco mais fácil.

  • (Somente WinDbg) Use o comando .lsrcpath (Definir Caminho de Origem Local) para exibir, definir, alterar ou acrescentar ao caminho de origem local. Se você estiver usando um servidor de origem, .lsrcfix (Usar Servidor de Origem Local) será um pouco mais fácil. Você também pode usar o Command-Line WinDbg com o parâmetro -lscrpath. Para obter mais informações, consulte Opções de Command-Line do WinDbg.

  • (Somente WinDbg) Usar o [Arquivo | Comando Caminho do Arquivo de Origem ou pressione CTRL+P para exibir, definir, alterar ou acrescentar ao caminho de origem ou ao caminho de origem local.

Você também pode abrir ou fechar diretamente um arquivo de origem seguindo um destes procedimentos:

  • Use o comando lsf (Carregar ou Descarregar Arquivo de Origem) para abrir ou fechar um arquivo de origem.

  • (Somente WinDbg) Use o comando .open (Arquivo de Software Livre) para abrir um arquivo de origem.

  • (Somente WinDbg) Usar o arquivo | código aberto comando de arquivo ou pressione ctrl+o para abrir um arquivo de origem. você também pode usar o botão código aberto arquivo (ctrl+o) na barra de ferramentas.

    Nota Quando você usa Arquivo | Arquivo de software livre (ou seu menu de atalho ou equivalentes de botão) para abrir um arquivo de origem, o caminho desse arquivo é acrescentado automaticamente ao caminho de origem.

  • (Somente WinDbg) Usar o arquivo | Comando Arquivos Recentes para abrir um dos quatro arquivos de origem que você abriu mais recentemente no WinDbg.

  • (Somente WinDbg) Usar o arquivo | Feche o comando Janela Atual ou selecione o botão Fechar no canto da janela Origem para fechar um arquivo de origem.

Confira também

Para obter mais informações sobre como usar arquivos de origem, consulte Depuração no modo de origem.