本地引用Mapperly源生成器库失效，VS Code中如何正确配置？

正确的本地引用配置 #

源生成器项目不能用普通的ProjectReference直接引用，必须添加特定属性让构建系统识别它的Analyzer类型。修改你的项目引用配置如下：

<ItemGroup>
  <ProjectReference Include="..\mapperly\src\Riok.Mapperly.Abstractions\Riok.Mapperly.Abstractions.csproj" />
  <ProjectReference Include="..\mapperly\src\Riok.Mapperly\Riok.Mapperly.csproj" 
                    OutputItemType="Analyzer" 
                    ReferenceOutputAssembly="false" />
</ItemGroup>

• OutputItemType="Analyzer"：告诉构建系统这是一个代码分析器（源生成器属于Analyzer范畴）
• ReferenceOutputAssembly="false"：避免将源生成器程序集作为普通依赖引用，只启用它的代码生成功能

必要的排查步骤 #

• 先构建本地Mapperly仓库：进入克隆的Mapperly仓库根目录，执行dotnet build确保源生成器项目编译完成，生成对应的dll文件。
• 清理构建缓存：删除你自己项目下的bin和obj目录，然后重启VS Code并重新加载项目（Ctrl+Shift+P → 选择"Reload Window"），避免旧缓存干扰。
• 手动触发构建并查看日志：在终端执行dotnet build，观察控制台输出，如果源生成器正常工作，会看到类似"Generating mapper implementations..."的日志信息。
• 确认框架兼容性：检查你的.NET 7项目的TargetFramework设置是否为<TargetFramework>net7.0</TargetFramework>，同时确认本地Mapperly项目的目标框架（通常是netstandard2.0）与.NET 7兼容。

报错原因说明 #

你遇到的Partial method must have an implementation part错误，本质是源生成器没有执行代码生成步骤。因为默认的ProjectReference不会触发源生成器的运行逻辑，导致你定义的partial映射方法只有接口定义，没有自动生成的实现代码。

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