Visual Studio 2019无法调试netstandard2.0项目的原因

核心原因 #

.NET Standard 本质是跨平台的类库标准，它本身不是可执行的运行时环境，没有自己的CoreCLR。你在项目中同时设置了：

• <TargetFramework>netstandard2.0</TargetFramework>（类库目标）
• <OutputType>Exe</OutputType>（可执行输出）

这种配置存在矛盾：编译器虽然能生成带有入口点的DLL，但Visual Studio调试器无法识别netstandard项目的运行时宿主，导致无法触发CoreCLR启动事件，自然无法在断点处停下。

解决办法 #

方案1：切换到具体的.NET运行时框架 #

如果你需要直接运行并调试这个项目，将目标框架改为兼容netstandard2.0的具体运行时，比如netcoreapp3.1或net5.0，修改后的csproj配置如下：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <PlatformTarget>AnyCPU</PlatformTarget>
    <TargetFramework>netcoreapp3.1</TargetFramework> <!-- 替换为具体运行时 -->
    <RootNamespace>basic_example</RootNamespace>
    <ImplicitUsings>disable</ImplicitUsings>
    <StartupObject>basic_example.LoopThroughInvalidFileChars</StartupObject>
    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
  </PropertyGroup>
    
  <ItemGroup>
    <PackageReference Include="DocumentFormat.OpenXml" Version="2.14.0" />
  </ItemGroup>
</Project>

修改后Visual Studio能识别对应的CoreCLR运行时，调试断点可以正常触发。

方案2：保留netstandard2.0，添加调试宿主项目 #

如果必须保留netstandard2.0作为类库（比如供其他项目引用），则：

• 将项目的<OutputType>改为Library，移除<StartupObject>配置
• 创建一个新的控制台项目（目标框架选netcoreapp3.1/net5.0等具体运行时），引用这个netstandard类库
• 通过调试新的控制台项目，间接调试netstandard类库中的代码

内容的提问来源于stack exchange，提问作者user32882