Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

时间:2021-06-08 05:26:02

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

背景

当我们在学习ASP.NET Core或者调试ASP.NET Core程序的时候,有时候需要调试底层代码,但是当我们在Visual Studio中调试程序的时候,由于一些基础库或者第三方库缺少pdb文件,所以调试这些库的代码的时候,会出现断点不能进去的情况。

例如,在如下代码中,我们希望调试一下View()方法,看看其中的内部实现

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

但是当我们点击F11之后,程序会直接跳到下一步

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

SourceLink是一组用于描述可嵌入到符号、二进制文件和包中的源代码控制元数据的包和规范。官网链接:https://github.com/dotnet/sourcelink

SourceLink当前支持的源代码来源

  • Github
  • Azure DevOps(VSTS)
  • TFS
  • Gitlab
  • Bitbucket

这里个人理解就是如果你调试的程序集是通过Nuget导入的,并且该程序集的源码是寄存在Github, VSTS等源代码平台中的,使用Source Link,调试阶段就会自动从源代码平台下载指定代码,并进入断点调试

标注:这里需要引入.NET Symbols的概念,我对这个理解的不是太深,希望有大牛给解释一下, 我后续再做补充。相关文章Publishing and Consuming Symbols and Source for Debugging

Visual Studio 2017 15.3以上版本中已经集成了Source Link, 具体开启方式如下

首先在 Options > Debugging > General中关闭Just My Code, 并启用Enable Source Link Support

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

然后在 Options > Debugging > Symbols中启用Microsoft Symbol Servers

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

最终效果

下面我们创建一个默认的asp.net core mvc站点,并以调试方式启动项目。 这里我们还是将断点打在HomeControllerIndex方法中。

当断点到达return View()代码块时,我们点击F11, Visual Studio会弹出以下窗口,提示你是否想要下载源文件进行调试

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码

点击确定之后,断点就进入了

Visual Studio 2017中使用SourceLink调试ASP.NET Core源码