源路径指定 C 和C++源文件所在的目录。
如果要在生成可执行文件的计算机上调试用户模式进程,并且源文件仍位于其原始位置,则调试器可以自动找到源文件。
在大多数其他情况下,必须设置源路径或加载单个源文件。
通过调试器执行远程调试时,调试服务器使用源路径。 如果使用 WinDbg 作为调试器,则每个调试客户端也有其自己的 本地源路径。 所有与源相关的命令都访问本地计算机上的源文件。 必须在想要使用源命令的任何客户端或服务器上设置正确的路径。
此多路径系统还允许调试客户端使用与源相关的命令,而无需实际与其他客户端或服务器共享源文件。 如果某个用户有权访问的私有或机密源文件,则此系统非常有用。
还可以随时加载源文件,而不考虑源路径。
源路径语法
调试器的源路径是由多个目录路径组成的字符串,用分号分隔。
支持相对路径。 但是,除非始终从同一目录中启动调试器,否则应在每个路径之前添加驱动器号或网络共享。 还支持网络共享。
注意 如果连接到企业网络,则访问源文件的最有效方法是使用源服务器。 可以使用源路径中的 srv\* 字符串来使用源服务器。 有关源服务器的详细信息,请参阅 “使用源服务器”。
控制源路径
若要控制源路径和本地源路径,可以执行以下作之一:
在启动调试器之前,请使用_NT_SOURCE_PATH 环境变量 设置源路径。 如果尝试通过此环境变量添加无效目录,调试器将忽略此目录。
启动调试器时,请使用 -srcpath命令行选项 设置源路径。
使用 .srcpath (设置源路径) 命令可显示、设置、更改或追加到源路径。 如果使用源服务器, .srcfix(使用源服务器) 会稍微容易一些。
(仅限 WinDbg)使用 .lsrcpath (设置本地源路径) 命令可显示、设置、更改或追加到本地源路径。 如果您使用源服务器,.lsrcfix(使用本地源服务器) 会使操作稍微容易一些。 还可以将 WinDbg Command-Line 与参数 -lscrpath 配合使用。 有关详细信息,请参阅 WinDbg 命令行选项。
(仅限 WinDbg)使用 [文件 |源文件路径 命令或按 Ctrl+P 显示、设置、更改或追加到源路径或本地源路径。
还可以通过执行下列作之一直接打开或关闭源文件:
使用 lsf(加载或卸载源文件) 命令打开或关闭源文件。
(仅限 WinDbg)使用 .open (开放源文件) 命令打开源文件。
(仅限 WinDbg)使用 文件 | 开放源文件 命令或按 ctrl+o 打开源文件。 还可以使用工具栏上的 开源文件(ctrl+o) 按钮。
注意 当您使用 文件 | 打开源文件(或其快捷菜单或按钮的等效项)打开源文件时,该文件的路径会自动追加到源路径。
(仅限 WinDbg)使用 文件 |“最近使用的文件” 命令打开最近在 WinDbg 中打开的四个源文件之一。
(仅限 WinDbg)使用文件 |关闭当前窗口命令,或选择“源”窗口角落的“关闭”按钮关闭源文件。
另请参阅
有关如何使用源文件的详细信息,请参阅 源模式下的调试。