如何通过NuGet包为项目属性的Build Action（生成操作）新增自定义选项

问题排查与解决方案 #

1. 检查props/targets文件名是否匹配包ID

NuGet会自动导入build、buildTransitive目录下与包ID完全同名的.props和.targets文件，若你的包ID为PermissionsNodeGenerator，则配置文件必须命名为PermissionsNodeGenerator.props、PermissionsNodeGenerator.targets，文件名不匹配会导致项目加载时无法识别自定义项配置。

2. 校验PropertyPageSchema架构文件格式

你的PermissionsText.xml必须符合Visual Studio项目架构定义规范，完整示例如下：

<?xml version="1.0" encoding="utf-8"?>
<ProjectSchemaDefinitions xmlns="http://schemas.microsoft.com/build/2009/properties">
  <ItemType Name="PermissionsText" DisplayName="Permissions Text File" />
  <FileExtension Name=".ptxt" ContentType="PermissionsText" />
  <ContentType Name="PermissionsText" DisplayName="Permissions Text File" ItemType="PermissionsText" />
</ProjectSchemaDefinitions>

缺少ItemType、ContentType、FileExtension任意一项配置，都会导致自定义项无法出现在生成操作列表中。

3. 清理Visual Studio缓存

VS项目系统存在本地缓存，配置正确但不生效时可按以下步骤清理：

• 关闭所有Visual Studio窗口
• 删除项目根目录下的.vs隐藏文件夹
• 删除路径%LocalAppData%\Microsoft\VisualStudio\<对应VS版本号>\ComponentModelCache下的所有缓存文件
• 重新打开VS加载项目验证

4. 验证配置加载逻辑

可在测试项目的.csproj文件中手动添加配置：

<ItemGroup>
  <AvailableItemName Include="PermissionsText" />
</ItemGroup>

若手动添加后自定义生成操作正常显示，说明NuGet包内的props文件未被正确导入，需检查包内文件的打包路径是否正确，确保.props、.targets、架构文件都被打包到了build和buildTransitive目录下。

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