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