dotnet 在 VisualStudio 一键 F5 启动调试 Roslyn 分析器项目

本文将告诉各人如安在 VisualStudio 里面，一键使用习惯的 F5 键进行快速构建和启动调试 Roslyn 分析器项目
在 dotnet 里面编写的 SourceGenerator 源代码生成器，或者是分析器时，可能编写的逻辑比较复杂，盼望制作一个项目进行调试。或者是原天职析器能够跑得好好的，莫名就在某个项目上应用失败，盼望能够调试失败的项目
本文将和各人介绍怎样使用 DebugRoslynComponent 启动方式进行调试启动 Roslyn 分析器项目
本文先告诉各人完全手动的编辑文件的配置方式，然后再告诉各人怎样通过图形化的配置方式作为日常工程化的配置
手动配置

开始之前，先确保被调试项目精确引用了 Roslyn 分析器项目。如本文这里有两个项目，分别是 JehairqogefaKaiwuwhailallkihaiki.Analyzer 分析器项目和 JehairqogefaKaiwuwhailallkihaiki 控制台项目
在 JehairqogefaKaiwuwhailallkihaiki 控制台项目里面引用 JehairqogefaKaiwuwhailallkihaiki.Analyzer 分析器项目，且在 csproj 里面设置 OutputItemType="Analyzer" ReferenceOutputAssembly="false" 属性，如以下代码所示。这两个属性的含义分别是 OutputItemType="Analyzer" 为配置将项目引用为分析器，而 ReferenceOutputAssembly="false" 则设置不引用其输出程序集内容，即不使用分析器项目里面的任何公开类型，不建立引用程序集关系

1. <Project Sdk="Microsoft.NET.Sdk">
3.   <PropertyGroup>
4.     <OutputType>Exe</OutputType>
5.     <TargetFramework>net9.0</TargetFramework>
6.     <ImplicitUsings>enable</ImplicitUsings>
7.     <Nullable>enable</Nullable>
8.   </PropertyGroup>
10.   <ItemGroup>
11.     <ProjectReference Include="..\JehairqogefaKaiwuwhailallkihaiki.Analyzer\JehairqogefaKaiwuwhailallkihaiki.Analyzer.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="false"/>
12.   </ItemGroup>
14. </Project>

复制代码

如果各人不确定自己的配置是否精确，可在本文末尾找到本文全部代码的下载方法，拉取本文的项目进行对比
确保 JehairqogefaKaiwuwhailallkihaiki.Analyzer 分析器项目精确配置了 IsRoslynComponent 属性，分析器项目的 csproj 项目文件代码如下

1. <Project Sdk="Microsoft.NET.Sdk">
3.   <PropertyGroup>
4.     <TargetFramework>netstandard2.0</TargetFramework>
5.     <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
6.     <IsRoslynComponent>true</IsRoslynComponent>
7.   </PropertyGroup>
9.   <ItemGroup>
10.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.11.0" />
11.   </ItemGroup>
13. </Project>

复制代码

完成准备工作之后，在 JehairqogefaKaiwuwhailallkihaiki.Analyzer 分析器项目添加 launchSettings.json 调试启动配置文件，在里面设置 DebugRoslynComponent 为 commandName 内容。将要被调试的 JehairqogefaKaiwuwhailallkihaiki 控制台项目相对路径设置到 targetProject 属性里面，其文件代码如下

1. {
2.   "profiles":
3.   {
4.     "JehairqogefaKaiwuwhailallkihaiki.Analyzer":
5.     {
6.       "commandName": "DebugRoslynComponent",
7.       "targetProject": "..\\JehairqogefaKaiwuwhailallkihaiki\\JehairqogefaKaiwuwhailallkihaiki.csproj"
8.     }
9.   }
10. }

复制代码

完成这些步骤之后，即可愉快的在分析器项目打上断点，设置分析器项目为启动项目，然后直接在 Visual Studio 使用 F5 一键运行启动调试分析器项目
本文代码放在 github 和 gitee 上，可以使用如下命令行拉代替码。我整个代码仓库比较庞大，使用以下命令行可以进行部门拉取，拉取速度比较快
先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

1. git init
2. git remote add origin https://gitee.com/lindexi/lindexi_gd.git
3. git pull origin c0e948b2a3aab521f2d6d86593c385f4d406cfa5

复制代码

以上使用的是国内的 gitee 的源，如果 gitee 不能访问，请替换为 github 的源。请在命令行继续输入以下代码，将 gitee 源换成 github 源进行拉代替码。如果依然拉取不到代码，可以发邮件向我要代码

1. git remote remove origin
2. git remote add origin https://github.com/lindexi/lindexi_gd.git
3. git pull origin c0e948b2a3aab521f2d6d86593c385f4d406cfa5

复制代码

获代替码之后，进入 Roslyn/JehairqogefaKaiwuwhailallkihaiki 文件夹，即可获取到源代码
图形化的配置方式

有伙伴说每次都须要新建 launchSettings.json 文件，这一点都不工程化，盼望能够有更加方便的做法。我接下来将和各人介绍更加 UI 图形化的配置方式。在如通过上文准备步骤，确保分析器项目精确配置了 IsRoslynComponent 属性，和被调试项目精确添加了分析器项目引用，配置了 OutputItemType="Analyzer" 之后，即可愉快进入以下的图形化的配置
本文使用的 Visual Studio 为 Visual Studio 2022 17.12.4 版本
配置步骤如下：
先在 解决方案资源管理器 里面右击分析器项目，点击 设为启动项目 选项，将分析器项目设置为启动项目
再点击分析器项目的调试属性，如下图所示

在打开的启动配置文件窗口里面，找个命令行参数，任意写入点字符。这个过程仅仅只是为了让 VisualStudio 帮助咱快速创建 launchSettings.json 文件而已。我现在还没有找到比这个方法更加随手便捷的方式哈

双击 Properties\launchSettings.json 文件进入编辑，现在可见的 launchSettings.json 文件的内容大概如下

1. {
2.   "profiles":
3.   {
4.     "JehairqogefaKaiwuwhailallkihaiki.Analyzer":
5.     {
6.       "commandName": "Project",
7.       "commandLineArgs": "123"
8.     }
9.   }
10. }

复制代码

此时将 commandName 属性的 Project 内容换成 DebugRoslynComponent 内容，再删除 commandLineArgs 等其他属性。此时先不要写 targetProject 属性项，因为这个属性项要写相对路径，手写太烦了。编辑完成之后的 launchSettings.json 文件的内容大概如下

1. {
2.   "profiles":
3.   {
4.     "JehairqogefaKaiwuwhailallkihaiki.Analyzer":
5.     {
6.       "commandName": "DebugRoslynComponent"
7.     }
8.   }
9. }

复制代码

继续点击分析器项目的调试属性，此时可见启动配置文件窗口界面如下

愉快点击下拉菜单，选择要调试项目即可，如下图所示

选中之后的效果如下图所示

完成之后，再次打开 launchSettings.json 文件，可以看到机智的 Visual Studio 已经帮咱填充了 targetProject 属性内容了。通过 Visual Studio 的填充，可以让咱不须要写繁琐的相对路径，也不用担心写错项目路径导致调试堕落

1. {
2.   "profiles":
3.   {
4.     "JehairqogefaKaiwuwhailallkihaiki.Analyzer":
5.     {
6.       "commandName": "DebugRoslynComponent",
7.       "targetProject": "..\\JehairqogefaKaiwuwhailallkihaiki\\JehairqogefaKaiwuwhailallkihaiki.csproj"
8.     }
9.   }
10. }

复制代码

如此就完成了配置工作
以下是一些踩坑履历
如果在打开的启动配置文件窗口里面，没有找到盼望的调试项目，如下图所示，那么可能的原因就是盼望的调试项目没有设置精确的分析器项目引用，即盼望被调试的项目的 csproj 项目文件里面缺少如  这样的代码，或分析器项目引用路径错误，引用了其他的分析器项目

无法启动调试 0x80070057 错误

在准备进入调试时，按下 F5 却被zz的 Visual Studio 提示如下错误

无法启动调试
不支持操作。未知错误：0x80070057。

或英文版的如下提示错误

Unable to start debugging.
Operation not supported. Unknown error: 0x80070057.

出现这个问题是 Visual Studio 缓存识别错误或被调试的项目路径错误，须要先关闭 Visual Studio 然后清算 sln 文件所在文件夹里的 .vs 文件夹，和各个项目的 bin 和 obj 文件夹。接着再重复点击分析器项目的调试属性，愉快点击下拉菜单，重新选择要调试项目即可

更多技术博客，请参阅 博客导航

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。