使用ILLink.Substitutions.xml配置泛型方法签名遇IL2009警告问题

出现IL2009警告的核心原因是ILLink无法匹配配置文件中指定的方法签名或类型，以下是针对性的排查和修复步骤：

1. 修正类型全名匹配问题 #

错误提示明确提到“找不到方法在类型NClass.NClass上”，但你的C#代码中类型的全名是NSpace.NClass。检查ILLink.Substitutions.xml中的<type fullname="NSpace.NClass">是否拼写正确，确保命名空间和类名完全匹配程序集中的实际类型。

2. 验证程序集全名准确性 #

<assembly fullname="NAssembly">中的fullname必须是目标程序集的完整名称：

• 如果是非强命名程序集，直接使用程序集文件名（不含.dll/.exe后缀）；
• 如果是强命名程序集，需要包含版本、文化和公钥令牌（例如NAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=abc123）。

你可以通过dnSpy或ILDasm工具打开程序集，查看其完整名称来确认。

3. 确保方法签名完全匹配 #

检查方法签名的每一部分是否与IL中的定义一致：

• 泛型参数数量：NGenericMethod1是正确的（对应单个泛型参数TGeneric`）；
• 参数顺序和类型：System.Boolean,System.Boolean,!0,System.String需严格匹配方法的参数列表（!0表示第一个泛型参数，这里对应TGeneric）；
• 返回值：System.Void对应方法的void返回类型，无需修改。

如果不确定IL签名，可以用dnSpy打开程序集，找到NGenericMethod方法，复制其IL签名到配置文件中。

修复后的配置示例 #

假设程序集全名和类型全名均正确，修正后的配置文件如下：

<?xml version="1.0" encoding="utf-8"?>
<linker>
    <assembly fullname="NAssembly">
        <type fullname="NSpace.NClass" feature="NAssembly.EnableFeature" featurevalue="false">
            <method signature="System.Void NGenericMethod`1(System.Boolean,System.Boolean,!0,System.String)" body="stub"/>
        </type>
    </assembly>
</linker>

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