.NET 6 Blazor PWA本地化资源加载失败、语言切换无效问题求助

针对你遇到的本地化文本不切换、显示资源键或始终显示默认语言的问题，以下是具体的排查点和修复方案：

1. 资源文件生成操作配置错误 #

.resx文件必须设置为嵌入式资源才能被程序读取，否则系统无法定位资源：

• 右键目标资源文件（如Resources.resx）→ 属性
• 将生成操作改为Embedded resource
• 确保所有语言版本的.resx文件都设置了此选项

2. Resources类与资源文件的命名空间/类名不匹配 #

空Resources类需要和资源文件严格对应，才能让IStringLocalizer<Resources>正确关联资源：

• 确认Resources类的命名空间为你的项目名.ResourceFiles（例如项目名为BlazorPWA，命名空间就是BlazorPWA.ResourceFiles）
• 类名必须和资源文件名完全一致（比如Resources.resx对应public class Resources { }）
• 类文件要放在ResourceFiles目录下，保证物理路径和命名空间对应

3. 文化切换未触发组件重新渲染 #

即使修改了CurrentCulture，Blazor组件不会自动重新渲染，需要手动触发更新：

• 在切换语言的方法中，设置文化后调用StateHasChanged()：

private void ChangeCulture(string culture)
{
    var cultureInfo = new CultureInfo(culture);
    CultureInfo.DefaultThreadCurrentCulture = cultureInfo;
    CultureInfo.DefaultThreadCurrentUICulture = cultureInfo;
    // 触发组件重新渲染
    StateHasChanged();
}

• 如果是全局切换语言，建议使用全局状态服务，通过事件通知所有组件更新：

public class CultureService
{
    public event Action OnCultureChanged;
    public void ChangeCulture(string culture)
    {
        var cultureInfo = new CultureInfo(culture);
        CultureInfo.DefaultThreadCurrentCulture = cultureInfo;
        CultureInfo.DefaultThreadCurrentUICulture = cultureInfo;
        OnCultureChanged?.Invoke();
    }
}

然后在组件中订阅事件并调用StateHasChanged()

4. 本地化器实例未重新获取 #

Blazor WebAssembly中IStringLocalizer默认是单例，切换文化后需要重新解析实例才能获取新语言的资源：

• 注入IServiceScopeFactory，在切换文化后创建新作用域并重新获取本地化器：

[Inject]
private IServiceScopeFactory ScopeFactory { get; set; }

private IStringLocalizer<Resources> _loc;

protected override void OnInitialized()
{
    _loc = ScopeFactory.CreateScope().ServiceProvider.GetRequiredService<IStringLocalizer<Resources>>();
    // 订阅文化变更事件，重新获取本地化器
}

5. 默认资源文件与默认文化的匹配问题 #

你设置默认文化为it-IT，但Resources.resx是中性文化（默认）资源：

• 如果希望it-IT作为默认，建议将Resources.it.resx的内容复制到Resources.resx中，或者确保it-IT文化下Resources.it.resx存在且包含所有资源键
• 检查其他语言的.resx文件是否包含对应的资源键（比如Resources.en.resx中是否有intro1项），缺失会显示默认资源的值

6. ResourcesPath路径大小写与目录结构问题 #

Blazor WebAssembly运行在浏览器环境下，路径区分大小写：

• 确认Program.cs中ResourcesPath = "ResourceFiles"的大小写和实际目录名完全一致（比如目录叫ResourceFiles就不能写成resourcefiles）
• 确认ResourceFiles目录直接在项目根目录下，没有嵌套在其他子目录中

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