.NET Core 3.1 MVC:如何在JS文件中使用resx多语言资源?
问题根因
独立.js静态文件会被Web服务器直接作为静态资源返回给浏览器,完全不会经过Razor视图引擎的解析流程,你写在里面的@localizer["NotificationManage"]语法不会被执行替换,只会作为普通文本原样输出,自然拿不到翻译内容。
可落地的实现方案
方案1:在布局页注入全局JS资源映射对象(生产环境首选)
你已经配置好的resx本地化逻辑完全不用改动,只需要在全站通用的_Layout.cshtml中,在所有业务JS文件加载之前,生成一个全局可访问的多语言资源对象,让独立JS直接读取即可。
实现步骤:
- 在
_Layout.cshtml中注入你需要用到的IHtmlLocalizer实例 - 写一个Razor渲染的script块,把JS需要用到的翻译资源序列化成合法的JS对象,挂到window全局变量上
示例代码:
@inject IHtmlLocalizer<ExampleProject.WEB.Controllers.HomeController> localizer <!-- 这段script必须放在所有业务独立JS的引用之前 --> <script> window.AppResources = { // 所有JS需要用到的资源在这里逐个定义,用Json.Serialize做安全序列化 notificationManage: @Html.Raw(Json.Serialize(localizer["NotificationManage"].Value)), saveSuccess: @Html.Raw(Json.Serialize(localizer["SaveSuccess"].Value)), deleteConfirm: @Html.Raw(Json.Serialize(localizer["DeleteConfirm"].Value)) }; </script>
- 独立JS文件中直接读取全局变量即可,不需要任何Razor语法:
// 独立JS文件中的业务代码 alert(window.AppResources.notificationManage);
方案注意点:
- 生成全局对象的script块,加载顺序必须早于你所有业务JS文件,否则JS执行时会拿不到未初始化的全局变量
- 翻译值必须用
Json.Serialize序列化,避免翻译文本里包含引号、换行、特殊符号时,破坏JS语法结构 - 仅把JS确实需要用到的资源暴露给前端,不要盲目把后端全部资源字典输出到页面,减少不必要的信息暴露和页面体积
方案2:后端提供本地化查询接口,JS按需拉取
如果JS需要用到的资源键非常多,手动逐个列在全局对象里维护成本太高,可以做一个专门的本地化接口,JS需要哪个资源就请求哪个接口:
- 后端新增控制器接口,复用现有的
IHtmlLocalizer逻辑:
[Route("localization")] public class LocalizationController : Controller { private readonly IHtmlLocalizer<HomeController> _localizer; public LocalizationController(IHtmlLocalizer<HomeController> localizer) { _localizer = localizer; } [HttpGet("{key}")] public IActionResult GetResource(string key) { // 给接口加静态缓存,减少重复请求 Response.Headers["Cache-Control"] = "public, max-age=2592000"; return Content(_localizer[key].Value); } }
- 独立JS中封装通用的资源获取方法:
const resourceCache = {}; async function getRes(key) { if (!resourceCache[key]) { const resp = await fetch(`/localization/${encodeURIComponent(key)}`); resourceCache[key] = await resp.text(); } return resourceCache[key]; } // 调用示例 alert(await getRes("NotificationManage"));
这个方案的优劣势很明显:
- 优势是不需要提前枚举所有资源键,维护成本低,适合大型模块化前端项目
- 劣势是首次获取资源会有网络请求延迟,必须做前端缓存,不然会造成不必要的流量浪费
方案3:把需要本地化的JS代码嵌入cshtml视图(不推荐生产使用)
如果你只有极小段的JS需要用到本地化内容,可以不把代码放到独立JS文件里,直接写到cshtml的script块中,让Razor引擎解析替换@localizer语法。
这种方式完全失去了独立JS文件可缓存、易维护的优势,只有临时写的简单脚本可以用,复杂项目长期维护成本很高,不推荐作为常规方案。
方案选型结论
- 绝大多数业务场景,方案1是综合成本最低、性能最好的最优选择,完全复用现有本地化体系,没有额外网络请求,和你当前已经写好的cshtml本地化逻辑无缝打通。
- 对于大型复杂前端项目,可以组合使用两个方案:把高频、通用的公共资源提前注入全局对象,把模块内低频、按需加载的资源走接口拉取,兼顾性能和维护灵活性。
内容的提问来源于stack exchange,提问作者Raşit Şahin
相关产品推荐
相关产品推荐

