跳至主要内容

在调试器中设置符号服务器

调试符号允许您进行更好的调试会话。 它们包含有关可执行文件和动态库中包含的函数的信息,并为您提供信息以获取清晰的调用堆栈。 符号服务器允许调试器自动加载正确的符号、二进制文件和源文件,而无需强制用户下载大型调试文件。 该服务器的功能类似于 Microsoft 的符号服务器,因此那里的文档可能很有用。

请注意,由于发布的 Electron 构建经过了大量优化,因此调试并不总是那么容易。 调试器将无法显示所有变量的内容,并且由于内联、尾调用和其他编译器优化,执行路径可能看起来很奇怪。 唯一的解决方法是构建一个未经优化的本地构建。

Electron 的官方符号服务器 URL 为 https://symbols.electronjs.org。 您不能直接访问此 URL,必须将其添加到调试工具的符号路径中。 在下面的示例中,使用本地缓存目录以避免重复从服务器获取 PDB。 将 c:\code\symbols 替换为您机器上合适的缓存目录。

在 Windbg 中使用符号服务器

Windbg 符号路径配置为以星号字符分隔的字符串值。 要仅使用 Electron 符号服务器,请将以下条目添加到您的符号路径(注意:您可以将 c:\code\symbols 替换为您计算机上的任何可写目录,如果您希望使用其他位置来下载符号)

SRV*c:\code\symbols\*https://symbols.electronjs.org

使用 Windbg 菜单,或通过键入 .sympath 命令,将此字符串设置为环境变量 _NT_SYMBOL_PATH。 如果您还想从 Microsoft 的符号服务器获取符号,您应该首先列出它

SRV*c:\code\symbols\*https://msdl.microsoft.com/download/symbols;SRV*c:\code\symbols\*https://symbols.electronjs.org

在 Visual Studio 中使用符号服务器

Tools -> Options

Symbols Settings

故障排除:符号未加载

在 Windbg 中键入以下命令以打印符号未加载的原因

> !sym noisy
> .reload /f electron.exe