Blazor类库本地化问题：RCL集成服务端Blazor失败及可行性咨询

开发者阿泽

2026-5-8

关于RCL集成Blazor本地化的问题解答

问题a：是否可创建包含本地化的RCL并集成到服务端Blazor应用中？

完全可以！Razor类库（RCL）的核心作用就是复用UI组件和相关业务逻辑，本地化资源自然也支持和主Blazor项目的本地化体系无缝集成，这是官方推荐的组件复用方案之一。

问题b：你哪里出错了？

你的思路方向是对的，但在资源文件配置、本地化类的实现细节上踩了几个坑，咱们一步步梳理修正：

1. 资源文件的核心配置缺失

你大概率没设置资源文件的生成操作属性：

选中RCL里所有.resx文件，右键打开属性窗口，把「生成操作」改为Embedded resource，否则资源不会被嵌入到RCL的程序集里，本地化工具根本读不到内容。
额外建议：把「自定义工具」设为ResXFileCodeGenerator（如果需要强类型资源，但用IStringLocalizer的话不是必须，但能避免命名错误）。

2. 本地化类的实现复杂化且存在匹配问题

你手动通过IStringLocalizerFactory创建本地化实例的方式容易出错，不如直接用泛型版本的IStringLocalizer<T>，它会自动关联对应程序集和命名空间的资源，简化代码的同时避免路径/命名空间匹配错误。

修正后的UIComponentLocalizer应该是这样：

namespace UI.Components;
public class UIComponentLocalizer
{
    private readonly IStringLocalizer<UIComponentText> _localizer;

    // 直接注入泛型本地化器，自动关联资源
    public UIComponentLocalizer(IStringLocalizer<UIComponentText> localizer)
    {
        _localizer = localizer;
        // 现在测试GetAllStrings应该能拿到资源内容了
        var allStrings = _localizer.GetAllStrings(false);
    }

    public LocalizedString this[string key] => _localizer[key];
    public LocalizedString GetLocalizedString(string key) => _localizer[key];
}

3. 资源文件与空类的命名空间不匹配

你的空类UIComponentText放在了Resources文件夹下，导致命名空间是UI.Components.Resources，但资源文件的命名约定应该和类的命名空间对应。更省心的做法是把空类放到RCL的根命名空间下：

UI.Components（RCL项目）
|-- UIComponentText.cs  // 根命名空间UI.Components
|-- Resources
    |-- UIComponentText.resx
    |-- UIComponentText.zh-CN.resx  // 对应文化的资源文件

UIComponentText.cs的内容只需保持空类即可：

namespace UI.Components;
public class UIComponentText { }

4. 主项目本地化配置的补充

确保你的Blazor主项目已经配置了本地化支持（如果之前没配的话），比如在Program.cs里：

// 注册本地化服务
builder.Services.AddLocalization(options => options.ResourcesPath = "Resources");

// 配置支持的文化
var supportedCultures = new[] { "en-US", "zh-CN", "de-DE" };
var localizationOptions = new RequestLocalizationOptions()
    .SetDefaultCulture(supportedCultures[0])
    .AddSupportedCultures(supportedCultures)
    .AddSupportedUICultures(supportedCultures);

app.UseRequestLocalization(localizationOptions);

最后验证步骤

重新编译RCL和主Blazor项目
在组件中注入UIComponentLocalizer后，尝试调用@CompTranslate["你的资源键"]，应该能正确显示对应文化的翻译内容了

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