Entitas项目中使用自定义代码生成器的问题排查指南

在使用Entitas框架开发时，代码生成器Jenny是一个非常重要的工具。本文将详细分析一个常见的Jenny自定义代码生成器使用问题，并提供完整的解决方案。

问题现象

开发者在尝试使用自定义代码生成器时，Jenny仍然使用默认的Entitas生成器，并输出JennyOutput.txt文件内容。尽管所有目录配置都正确且包含必要的DLL文件，但自定义生成器无法正常工作。

根本原因分析

经过排查，发现问题的根源在于系统环境变量中缺少MSBuild的路径配置。MSBuild是.NET项目构建的核心工具，Jenny依赖它来加载和运行自定义代码生成器。

解决方案

步骤1：验证MSBuild安装

首先需要确认系统是否已安装MSBuild。可以通过以下方法检查：

1. 打开命令提示符(cmd)
2. 输入命令：MSBuild -version
3. 如果返回版本信息，则说明已安装；否则需要安装

步骤2：添加MSBuild到系统PATH

如果MSBuild已安装但不在系统PATH中，需要手动添加：

1. 找到MSBuild的安装路径（通常在Visual Studio安装目录下）
2. 右键"此电脑"→"属性"→"高级系统设置"→"环境变量"
3. 在系统变量中找到Path，点击编辑
4. 添加MSBuild的路径（如：C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuild\Current\Bin）

步骤3：验证Jenny配置

确保Jenny.properties文件配置正确：

Jenny.SearchPaths = Assets/Libraries/Entitas/Editor/Plugins
Jenny.Plugins = DesperateDevs.Entitas.Roslyn, DesperateDevs.CodeGeneration.Plugins
Jenny.Generators = Your.Custom.Generator.Namespace

步骤4：重新运行Jenny

完成上述配置后，重新运行Jenny代码生成器。虽然控制台可能仍会显示"No context policies"信息，但自定义代码生成器应该能够正常工作了。

注意事项

1. 不同版本的Visual Studio可能有不同的MSBuild路径
2. 确保使用的MSBuild版本与项目.NET版本兼容
3. 如果使用多个Visual Studio版本，建议使用最新版本的MSBuild
4. 在团队开发环境中，建议统一开发环境配置

通过以上步骤，应该能够解决Jenny无法使用自定义代码生成器的问题。如果问题仍然存在，建议检查自定义生成器的实现是否正确，以及所有依赖项是否都已正确引用。