Blazor IStringLocalizer 多语言实现教程

Blazor 多语言核心是 IStringLocalizer + .resx 资源文件 + 语言切换逻辑，不依赖 JS；需在 Program.cs 注册 AddLocalization()，按规范命名资源文件（如 SharedResource.zh-CN.resx），组件中 @inject IStringLocalizer 使用，Server/WASM 切换文化方式不同但均原生支持。

Blazor 中使用 IStringLocalizer 实现多语言，核心是结合 .NET 的本地化服务 + 资源文件（.resx）+ 语言切换逻辑。它不依赖 JavaScript，完全在 C# 层完成，适合 Server、WASM 和 Hybrid 项目。

配置本地化服务

在 Program.cs（.NET 6+）中注册本地化服务：

• Server 项目：调用 builder.Services.AddRazorComponents().AddInteractiveServerComponents() 后，添加 AddLocalization()
• WASM 项目：同样调用 AddLocalization()，并确保资源文件被正确发布（默认会自动包含）
• 语言文化需通过 RequestLocalizationOptions 设置支持列表，例如 new[] { "zh-CN", "en-US", "ja-JP" }

准备资源文件（.resx）

资源文件必须按命名规范放置，Blazor 才能自动匹配：

• 新建文件夹 Resources（推荐），在其中创建 SharedResource.resx（默认语言，如中文）
• 对应英文版： SharedResource.en-US.resx；日文版：SharedResource.ja-JP.resx
• 文件属性中，将 Build Action 设为 Embedded Resource，Custom Tool 留空（不要设为 PublicResXFileCodeGenerator）
• 类名不重要，但资源键名要统一，比如 WelcomeMessage，各语言文件里填对应翻译

在组件中注入并使用 IStringLocalizer

以 Razor 组件为例（如 Counter.razor）：

• 顶部注入： @inject IStringLocalizer localizer（注意泛型参数是资源类类型，不是字符串）
• 使用方式： @localizer["WelcomeMessage"] 或带参数的 @localizer["HelloName", @name]
• 若资源类未显式定义（即只用 .resx），可借助一个空的 SharedResource.cs 文件（内容仅 public class SharedResource { }），让编译器生成类型引用

动态切换语言并持久化用户选择

切换语言本质是改变当前线程/请求的 CultureInfo，并在客户端保存偏好：

• Server 渲染：通过中间件或自定义 ICultureService 在每次请求前设置 HttpContext.Features.Get().RequestCulture
• WASM 渲染：无法改线程文化，改用 JSInterop 存 localStorage，再在 App.razor 中用 CultureChanged 事件触发重载，或配合 NavigationManager.Refresh()
• 推荐轻量方案：封装一个 LanguageService，提供 ChangeLanguage(string culture) 方法，内部更新 CultureInfo.DefaultThreadCurrentCulture（WASM 不生效，仅作标记）+ 触发状态通知

基本上就这些。关键点是资源文件命名、注入方式、以及区分 Server/WASM 的文化切换机制。不需要第三方库，.NET 原生支持很稳。

# javascript  # java  # js  # app  # 多语言  # 本地化  # c#  # .net  # red 

相关文章： 建站VPS能否同时实现高效与安全翻墙？  武汉网站如何制作,黄黄高铁武穴北站途经哪些村庄？  表情包在线制作网站免费,表情包怎么弄？  建站三合一如何选？哪家性价比更高？  免费视频制作网站,更新又快又好的免费电影网站？  网站制作与设计教程,如何制作一个企业网站，建设网站的基本步骤有哪些？  建站之星价格显示格式升级，你的预算足够吗？  如何在Windows环境下新建FTP站点并设置权限？  贸易公司网站制作流程,出口贸易网站设计怎么做？  如何在宝塔面板中修改默认建站目录？  如何通过可视化优化提升建站效果？  如何在腾讯云免费申请建站？  湖州网站制作公司有哪些,浙江中蓝新能源公司官网？  北京制作网站的公司,北京铁路集团官方网站？  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站？  广州网站设计制作一条龙,广州巨网网络科技有限公司是干什么的？  枣阳网站制作,阳新火车站打的到仙岛湖多少钱？  企业网站制作费用多少,企业网站空间一般需要多大，费用是多少？  网站制作公司广州有几家,广州尚艺美发学校网站是多少？  mc皮肤壁纸制作器,苹果平板怎么设置自己想要的壁纸我的世界？  如何快速搭建高效服务器建站系统？  如何在企业微信快速生成手机电脑官网？  实例解析Array和String方法  车管所网站制作流程,交警当场开简易程序处罚决定书，在交警网站查询不到怎么办？  深圳企业网站制作设计,在深圳如何网上全流程注册公司？  制作门户网站的参考文献在哪,小说网站怎么建立？  建站之星伪静态规则如何正确配置？  大同网页,大同瑞慈医院官网？  宝盒自助建站智能生成技巧：SEO优化与关键词设置指南  如何零基础在云服务器搭建WordPress站点？  广州网站建站公司选择指南：建站流程与SEO优化关键词解析  网站制作报价单模板图片,小松挖机官方网站报价？  建站org新手必看：2024最新搭建流程与模板选择技巧  北京专业网站制作设计师招聘,北京白云观官方网站？  如何通过WDCP绑定主域名及创建子域名站点？  Dapper的Execute方法的返回值是什么意思 Dapper Execute返回值详解  齐河建站公司：营销型网站建设与SEO优化双核驱动策略  建站之星安装后如何自定义网站颜色与字体？  如何在橙子建站上传落地页？操作指南详解  SAX解析器是什么，它与DOM在处理大型XML文件时有何不同？  网站建设制作、微信公众号,公明人民医院怎么在网上预约？  高性价比服务器租赁——企业级配置与24小时运维服务  高性能网站服务器部署指南：稳定运行与安全配置优化方案  义乌企业网站制作公司,请问义乌比较好的批发小商品的网站是什么？  如何高效利用亚马逊云主机搭建企业网站？  如何设置并定期更换建站之星安全管理员密码？  如何在IIS管理器中快速创建并配置网站？  建站之星安装路径如何正确选择及配置？  建站之星备案流程有哪些注意事项？  桂林网站制作公司有哪些,桂林马拉松怎么报名？