在 .NET 多平台应用 UI（MAUI）开发日益普及的今天，开发者社区关于“资源文件自动化”的讨论热度不减。近日，一则来自技术论坛的灵魂拷问引发广泛关注：“Can XX.Designer.cs be autogenerated from XX.resx in Visual Studio Code MAUI?” 看似简单的技术问题，背后却折射出跨平台开发工具链的适应性与开发者工作效率之间的深层矛盾。

资源文件与代码生成：一个古老而关键的机制

要理解这个问题的核心，必须先厘清 .resx 和 .Designer.cs 之间的关系。在 .NET 生态中，.resx 文件用于存储本地化字符串、图片、文件等资源。开发者在 .resx 中添加键值对后，传统做法是由 Visual Studio 或 MSBuild 自动生成对应的 .Designer.cs 文件。这个 C# 代码文件为每个资源项生成强类型属性，让开发者能通过 Resources.MyString 这样的形式访问资源，避免硬编码字符串、支持编译时检查。

在 Windows Forms、WPF 和经典的 Xamarin.Forms 项目中，这个生成机制几乎“无感”运行。然而，当开发环境切换到轻量级的 Visual Studio Code，并转向 MAUI 项目时，开发者发现：自动生成似乎“失灵”了。

VS Code + MAUI：自动化缺失的尴尬

MAUI 作为 .NET 6 之后的主力跨平台框架，官方推荐使用 Visual Studio 2022（Windows/Mac）或 Visual Studio Code（配合 C# 扩展与 .NET CLI）进行开发。但两者在资源文件的体验上存在显著差异。

在 Visual Studio 中，每当 .resx 文件被保存或项目被构建时，MSBuild 任务 GenerateResource 会自动生成并更新 .Designer.cs。开发者甚至可以通过“自定义工具”属性（如 PublicResXFileCodeGenerator）控制生成范围。

而在 VS Code 中，情况变得复杂。VS Code 本身是编辑器，不具备 Visual Studio 项目系统的“设计时生成”能力。尽管 .NET SDK 的 MSBuild 在编译时会执行资源处理，但 .Designer.cs 文件是否自动生成，取决于项目文件（.csproj）中的配置。很多 MAUI 项目默认并未包含相应的生成规则，导致资源文件虽能编译，却没有强类型访问类。开发者只能通过 ResourceManager.GetString() 手动读取，既繁琐又易错。

社区开发者“TechBridge”在帖中坦言：“我花了整整两天时间查找，才发现 VS Code 下 .resx 的 auto-generate 没有被触发。最终手动添加了 .csproj 的目标才解决。” 类似遭遇在 Stack Overflow、GitHub Issues 中屡见不鲜。

解决方案：手动配置与工具插件

面对这一困境，解决方案已经浮出水面。最直接的方式是在 .csproj 文件中显式启用资源代码生成。添加以下目标即可：

<ItemGroup>
  <EmbeddedResource Update="Resources\Strings\XX.resx" Generator="ResXFileCodeGenerator" 
                    LastGenOutput="XX.Designer.cs" />
</ItemGroup>
<ItemGroup>
  <Compile Update="Resources\Strings\XX.Designer.cs" DesignTime="True" AutoGen="True" 
           DependentUpon="XX.resx" />
</ItemGroup>

但这条方案要求开发者对 MSBuild 语法有一定了解，并非开箱即用。为此，第三方插件如 ResX Resource Manager 和 ResX2Code 应运而生。前者提供 VS Code 扩展，允许在编辑 .resx 时一键生成代码；后者则支持命令行工具，可集成到 CI/CD 流水线。

微软官方也在改善这一体验。在 .NET 8 及更高版本中，MAUI 模板默认包含 Microsoft.Extensions.Localization 和强类型资源生成器，但默认仅适用于 Strings.resx 等特定路径。有迹象表明，.NET 9 将进一步统一资源代码生成逻辑。

深度思考：跨平台开发工具链的成熟度

这一问题的本质，是 .NET 桌面/移动开发从重量级 IDE 向轻量级编辑器迁移过程中，部分“设计时特性”失落的缩影。VS Code 的灵活性以配置复杂度为代价。对于团队中的新手开发者，这种“隐性知识”往往成为生产力瓶颈。

资深 .NET 架构师 James Montemagno 在个人博客中指出：“MAUI 的愿景是‘一处编写，处处运行’，但目前工具链的碎片化让开发者被迫掌握两套工作流——一套给 VS，一套给 VS Code。资源文件的自动生成只是冰山一角。” 他建议微软在 .NET CLI 中增加 dotnet maui add-resource 等命令，将代码生成从 IDE 解耦到命令行。

未来展望：更智能的生成或完全重塑？

短期来看，开发者需要主动配置项目文件或借助插件。而长期方向则可能有两种：其一，微软在 MAUI 的 .targets 文件中内置更通用的资源生成逻辑，使其在 VS Code 下也能自动触发（类似 dotnet build 时自动处理源生成器）；其二，社区呼吁抛弃传统 .Designer.cs 模式，全面转向 C# 源生成器（Source Generators），后者无需额外文件，在编译时直接注入代码，且与任何编辑器无关。

目前，ResXSourceGenerator 等开源项目已实现这一理念，只需在项目中引用 NuGet 包，即可在 VS Code 中获得强类型资源。这或许才是最终答案。

对于仍在纠结“XX.Designer.cs 能否自动生成”的开发者，我们的建议是：不必死守传统模式，拥抱源生成器或配置自动化脚本，让工具回归工具的本质。MAUI 的征程才刚刚开始，资源管理的小切口，恰恰是跨平台工具走向成熟必须迈过的门槛。