通过 Visual Studio for Mac 中的源链接调试 NuGet 包

  • 项目

重要

根据 Microsoft 的新式生命周期策略，Visual Studio for Mac 计划于 2024 年 8 月 31 日停用。 虽然你可以继续使用 Visual Studio for Mac，但 Mac 上的开发人员还可以使用其他几个选项，例如适用于 VS Code 的新 C# 开发工具包扩展的预览版本。

详细了解支持时间表和替代方案。

源链接是一种可以从 NuGet 对 .NET 程序集进行源代码调试的技术，从而将带有源链接的 .PDB 发送给源文件。 源链接在开发人员创建 NuGet 包时执行，然后将源代码管理元数据嵌入在程序集和包中。 如果在 Visual Studio for Mac 中启用源链接，IDE 将检测源文件是否适用于已安装的包。 然后，Visual Studio for Mac 将提供下载，你可以单步执行包代码。 源链接也适用于 Xamarin 项目的 Mono 基类库代码，使你也可以单步执行 .NET Framework 代码。 源链接提供源代码管理元数据来创造出色的调试体验。

注意

Visual Studio for Mac 目前不支持符号服务器。 因此，不支持具有符号服务器上托管的元数据的源链接。

要在 Visual Studio for Mac 中启用源链接，请浏览到“Visual Studio”>“首选项...”>“项目”>“调试器”，并确保选中“单步执行外部代码”复选框。

Screenshot of preferences dialog showing Step into external code checkbox

可以更改“下载外部代码”中的设置，以满足你的偏好：

  • 询问：Visual Studio for Mac 将提示你下载外部代码
  • 始终：Visual Studio for Mac 将自动下载外部代码
  • 从不：Visual Studio for Mac 不会下载相关外部代码

默认情况下，选择的是“询问”。 如果找到 NuGet 包的外部代码，则会收到以下提示：

Screenshot of prompt that appears when external code is found for a NuGet package

另请参阅