ASP.NET Core提供了完善的本地化与全球化支持，开发者可以通过内置的服务和中间件快速实现应用的多语言适配，让不同地区的用户都能看到符合自身语言习惯的界面内容。多语言支持的核心逻辑是通过资源文件存储不同语言的文本，再根据用户的语言偏好动态加载对应的资源内容。
核心概念说明
在ASP.NET Core的多语言体系中，有两个核心概念需要明确：
- 全球化（Globalization）：指应用支持多种文化的能力，包括日期、数字、货币等格式的适配。
- 本地化（Localization）：指根据特定文化的规则，将应用内容转换为对应语言的过程。
每个文化都有对应的文化代码，比如zh-CN代表中文（中国大陆），en-US代表英语（美国），应用会根据这些代码匹配对应的资源文件。
基础配置步骤
1. 注册本地化服务
首先需要在Program.cs中注册本地化相关的服务，指定支持的文化列表和默认文化：
// 添加本地化服务
builder.Services.AddLocalization(options =>
{
// 资源文件的存放根目录，默认是Resources
options.ResourcesPath = "Resources";
});
// 配置支持的文化列表
var supportedCultures = new[] { "zh-CN", "en-US" };
var localizationOptions = new RequestLocalizationOptions()
.SetDefaultCulture(supportedCultures[0])
.AddSupportedCultures(supportedCultures)
.AddSupportedUICultures(supportedCultures);
// 将本地化配置注入服务
builder.Services.Configure<RequestLocalizationOptions>(options =>
{
options.DefaultRequestCulture = new RequestCulture(supportedCultures[0]);
options.SupportedCultures = supportedCultures.Select(c => new CultureInfo(c)).ToList();
options.SupportedUICultures = supportedCultures.Select(c => new CultureInfo(c)).ToList();
});
2. 添加本地化中间件
注册服务后，需要在中间件管道中添加请求本地化中间件，让应用能够根据请求信息判断用户的文化偏好：
var app = builder.Build();
// 获取之前配置的本地化选项
var locOptions = app.Services.GetRequiredService<IOptions<RequestLocalizationOptions>>();
// 使用请求本地化中间件，需要放在路由中间件之前
app.UseRequestLocalization(locOptions.Value);
app.MapControllerRoute(
name: "default",
pattern: "{controller=Home}/{action=Index}/{id?}");
app.Run();
资源文件创建与使用
资源文件是存储不同语言文本的核心载体，ASP.NET Core会根据文化代码自动匹配对应的资源文件。资源文件的命名规则为类名.文化代码.resx，如果不带文化代码则表示默认资源文件。
比如我们要给HomeController添加多语言文本，需要创建以下资源文件，都放在之前配置的Resources目录下：
Controllers.HomeController.resx：默认资源文件，存储默认文化的文本（这里是zh-CN的内容）Controllers.HomeController.en-US.resx：英语（美国）对应的资源文件
资源文件的内容以键值对形式存储，比如默认资源文件中添加键为Welcome，值为欢迎访问我们的网站；英语资源文件中同样键为Welcome，值为Welcome to our website。
在控制器中使用资源文件
控制器中可以通过注入IStringLocalizer来获取对应文化的文本：
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Localization;
namespace WebApp.Controllers
{
public class HomeController : Controller
{
private readonly IStringLocalizer<HomeController> _localizer;
// 注入对应控制器的本地化器
public HomeController(IStringLocalizer<HomeController> localizer)
{
_localizer = localizer;
}
public IActionResult Index()
{
// 通过键获取对应文化的文本
ViewBag.WelcomeText = _localizer["Welcome"];
return View();
}
}
}
在视图中使用资源文件
视图中同样可以注入本地化器来获取文本，也可以通过IHtmlLocalizer处理包含HTML的内容：
@using Microsoft.AspNetCore.Mvc.Localization @inject IStringLocalizer<HomeController> Localizer <h1>@Localizer["Welcome"]</h1> <p>当前文化：@System.Globalization.CultureInfo.CurrentCulture.Name</p>
语言切换实现
默认情况下，ASP.NET Core的本地化中间件会按照以下顺序判断用户的语言偏好：查询字符串中的culture参数、Cookie中的.AspNetCore.Culture值、请求头的Accept-Language字段。我们可以实现一个语言切换的功能，通过修改Cookie来持久化用户的语言选择。
首先创建一个语言切换的控制器方法：
public IActionResult SetCulture(string culture, string redirectUri)
{
if (!string.IsNullOrEmpty(culture))
{
// 设置Cookie存储用户选择的文化
HttpContext.Response.Cookies.Append(
".AspNetCore.Culture",
CookieRequestCultureProvider.MakeCookieValue(new RequestCulture(culture)),
new CookieOptions { Expires = DateTimeOffset.UtcNow.AddYears(1) }
);
}
// 重定向回之前的页面
return LocalRedirect(redirectUri ?? "/");
}
然后在视图中添加语言切换的链接：
<div>
<a asp-controller="Home" asp-action="SetCulture" asp-route-culture="zh-CN" asp-route-redirectUri="@Context.Request.Path">中文</a>
<a asp-controller="Home" asp-action="SetCulture" asp-route-culture="en-US" asp-route-redirectUri="@Context.Request.Path">English</a>
</div>
常见问题说明
- 如果资源文件没有被正确加载，需要检查资源文件的命名是否符合规则，以及
ResourcesPath的配置是否正确。 - 如果切换语言后没有立即生效，可以检查中间件的位置是否正确，请求本地化中间件需要放在路由中间件之前。
- 对于共享的文本，可以创建公共的资源文件，比如
SharedResource.resx，然后通过注入IStringLocalizer<SharedResource>来使用，不需要创建对应的SharedResource类。
ASP.NET_Core多语言支持本地化全球化资源文件修改时间：2026-07-17 04:54:29