You need to enable JavaScript to run this app. .NET Core 3.1 MVC:如何在JS文件中使用resx多语言资源?
优惠活动
大模型
产品
解决方案
定价
更多

.NET Core 3.1 MVC:如何在JS文件中使用resx多语言资源?

问题根因

独立.js静态文件会被Web服务器直接作为静态资源返回给浏览器,完全不会经过Razor视图引擎的解析流程,你写在里面的@localizer["NotificationManage"]语法不会被执行替换,只会作为普通文本原样输出,自然拿不到翻译内容。

可落地的实现方案

方案1:在布局页注入全局JS资源映射对象(生产环境首选)

你已经配置好的resx本地化逻辑完全不用改动,只需要在全站通用的_Layout.cshtml中,在所有业务JS文件加载之前,生成一个全局可访问的多语言资源对象,让独立JS直接读取即可。
实现步骤:

  1. 在_Layout.cshtml中注入你需要用到的IHtmlLocalizer实例
  2. 写一个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>
  1. 独立JS文件中直接读取全局变量即可,不需要任何Razor语法:
// 独立JS文件中的业务代码
alert(window.AppResources.notificationManage);

方案注意点:

  • 生成全局对象的script块,加载顺序必须早于你所有业务JS文件,否则JS执行时会拿不到未初始化的全局变量
  • 翻译值必须用Json.Serialize序列化,避免翻译文本里包含引号、换行、特殊符号时,破坏JS语法结构
  • 仅把JS确实需要用到的资源暴露给前端,不要盲目把后端全部资源字典输出到页面,减少不必要的信息暴露和页面体积

方案2:后端提供本地化查询接口,JS按需拉取

如果JS需要用到的资源键非常多,手动逐个列在全局对象里维护成本太高,可以做一个专门的本地化接口,JS需要哪个资源就请求哪个接口:

  1. 后端新增控制器接口,复用现有的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);
    }
}
  1. 独立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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 15:24:02