ASP.NET Core中_Layout.cshtml使用本地化功能时文化切换后文本不生效

按出现概率从高到低逐一排查 #

• 中间件注册顺序错误
  ASP.NET Core 中间件按注册顺序执行，UseRequestLocalization 必须放在管道靠前位置，优先于路由、MVC端点、静态文件中间件注册。如果把该中间件放在UseRouting、UseEndpoints、UseMvc之后，文化解析逻辑不会对后续请求生效。

  正确的管道顺序：

  // 优先注册本地化中间件
  app.UseRequestLocalization(app.ApplicationServices.GetRequiredService<IOptions<RequestLocalizationOptions>>().Value);
  app.UseStaticFiles();
  app.UseRouting();
  app.UseAuthorization();
  app.UseEndpoints(endpoints => { endpoints.MapControllerRoute(name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); });
  

• 选项依赖解析错误
  代码中获取RequestLocalizationOptions时如果未指定泛型参数，无法正确读取之前在ConfigureServices中配置的支持文化列表。当前代码中的IOptions必须明确指定泛型为RequestLocalizationOptions，否则会加载系统默认的文化配置，自定义的支持文化列表完全不生效。

  // 错误写法：无泛型参数，无法匹配已配置的选项
  app.UseRequestLocalization(app.ApplicationServices.GetRequiredService<IOptions>().Value);
  // 正确写法：指定泛型类型
  app.UseRequestLocalization(app.ApplicationServices.GetRequiredService<IOptions<RequestLocalizationOptions>>().Value);
  

• 资源文件配置不符合加载规则
  针对_Layout.fr.resx、_Layout.en.resx这类嵌入资源文件，需逐一核查文件属性：
  • 资源文件的生成操作需设置为嵌入的资源，不能选择“无”或“内容”
  • 资源文件的自定义工具属性需清空，不要指定强类型生成工具，避免生成的资源类命名空间与程序预期不匹配
  • 需补充放置无语言后缀的基础主资源文件_Layout.resx，仅存放带语言后缀的多语言文件会导致本地化引擎无法定位资源基类
• 视图本地化依赖注入缺失
  在_Layout.cshtml顶部需通过@inject语法显式注入IViewLocalizer服务。如果页面中直接声明了@localizer变量但没有绑定实际的本地化服务实例，会始终直接返回传入的原始文本，不会匹配对应资源做翻译。

  正确的视图注入写法：

  @inject IViewLocalizer localizer
  

• 文化切换逻辑未正确传递参数
  检查语言切换组件_Culture.cshtml的跳转逻辑，需按照ASP.NET Core默认的文化解析规则传递参数：
  • 跳转链接需附带?culture=fr的查询字符串参数
  • 或切换时正确写入名称为.AspNetCore.Culture的Cookie，Cookie值需符合c=fr|ui-c=fr的格式要求
    仅在页面上展示切换按钮、未正确传递文化参数的情况下，请求会始终使用默认的英语文化配置。

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