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

背景#

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

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

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

Source Link#

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中使用Source Link#

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

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

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

最终效果#

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

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

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