Source Link allows developers to debug the source code from libraries they are using. Tools like Visual Studio can step into its source code what helps you find out what is going on behind the scenes. Let’s see how we can enable SourceLink debugging in Visual Studio:
- Go to Tools > Options > Debugging > Symbols and check if the ‘NuGet.org Symbol Server’ option is checked. It is recommended to specify a local directory that can be used as a symbol cache to avoid the need to download symbols every time:
- Disable 'Just My Code' in Tools > Options > Debugging > General to make the debugger load symbols that are not part of your current solution. Also check that the 'Enable Source Link support' is set (which should be the case by default):
- When you now try to debug code, you can step into the code through F11. Visual Studio will ask you to download the corresponding source code:
Troubleshooting
In case you get a ‘File Dialog’ asking you to specify the source location, it can be the case that you don’t have access to the source repository.
In that case click on ‘Cancel’ in the dialog. You’ll end up on the 'Source Link Authentication failed' window. Here you can try to authenticate (again) by selecting the 'Authenticate with Source Link' option from the list of available actions: