.NET MAUI部署iOS遇ILStrip错误：找不到OptimizerApp.resources.dll

问题根源 #

报错中的OptimizerApp.resources.dll是项目本地化资源附属程序集，由.resx格式的资源字典编译生成，对应特定语言区域（示例中的de代表德语）。ILStrip是iOS构建流程中用于裁剪冗余IL代码的工具，当它尝试处理这类附属程序集时，若文件未生成、路径错误或构建流程配置异常，就会触发找不到文件的错误。

导致该文件缺失的常见因素：

• .resx文件的生成操作或自定义工具配置错误，未正确编译为附属程序集
• 多语言本地化配置冲突，导致特定语言的资源程序集未生成
• 构建缓存损坏，旧路径残留导致ILStrip找不到新生成的文件
• 项目中误将本地化资源标记为其他类型（如MauiImage），干扰了资源编译流程

解决方案 #

1. 修正.resx文件配置 #

• 主资源文件（如Resources.resx）：设置生成操作为EmbeddedResource，自定义工具为ResXFileCodeGenerator
• 本地化资源文件（如Resources.de.resx）：同样设置生成操作为EmbeddedResource，自定义工具保持ResXFileCodeGenerator，确保编译后生成对应语言的.resources.dll

2. 跳过资源程序集的ILStrip处理 #

若不需要对本地化资源进行IL裁剪，可在项目.csproj文件中添加以下配置，直接跳过ILStrip对附属资源的处理：

<PropertyGroup>
  <ILStripSkipResources>true</ILStripSkipResources>
</PropertyGroup>

3. 清理构建缓存并重新构建 #

• 删除项目根目录下的bin和obj文件夹
• 删除iOS构建缓存目录：/Users/oxo/Library/Caches/Xamarin/mtbs/builds/OptimizerApp/下对应项目的缓存文件夹
• 执行dotnet clean后再重新进行Release构建

4. 排查资源冲突与配置错误 #

• 检查项目中是否存在重名资源（如图片与.resx文件同名），避免编译时资源路径混乱
• 确认.resx文件中未引用不存在的资源，防止编译失败导致附属程序集生成不完整
• 检查项目文件中是否有错误的资源属性配置，比如误将.resx标记为MauiImage或MauiFont

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