ASP.NET Core基于角色的访问控制中角色标识翻译的最佳实践是什么

这是最适配ASP.NET Core原生生态的方案，无需引入第三方依赖，后续扩展多语种也非常方便，落地步骤如下：

第一步：配置本地化服务 #

在Program.cs中注册本地化相关服务，指定资源文件存放路径：

using System.Globalization;
using Microsoft.AspNetCore.Localization;

// 注册本地化服务
builder.Services.AddLocalization(options => options.ResourcesPath = "Resources");

// 配置支持的语种
builder.Services.Configure<RequestLocalizationOptions>(options =>
{
    var supportedCultures = new[]
    {
        new CultureInfo("en"), // 英文兜底
        new CultureInfo("ar"), // 示例中的阿拉伯语，新增语种直接加在这里即可
        new CultureInfo("zh-CN")
    };
    options.DefaultRequestCulture = new RequestCulture("ar");
    options.SupportedCultures = supportedCultures;
    options.SupportedUICultures = supportedCultures;
});

// 中间件管道中启用本地化，注意要放在路由中间件之前
app.UseRequestLocalization();

第二步：创建翻译资源文件 #

在项目根目录新建Resources文件夹，按语种创建权限标识对应的资源文件：

• PermissionClaims.resx：默认兜底资源，键填写你的权限标识（如CanCreateUser），值填写默认展示文本
• PermissionClaims.ar.resx：阿拉伯语专用资源，键和上面保持完全一致，值填写对应翻译内容（如اضافة مستخدم），所有角色标识都按这个规则录入键值对即可
  注意：资源文件的访问修饰符要设置为Public，否则代码中无法正常读取

第三步：业务代码中调用翻译 #

直接注入IStringLocalizer即可读取翻译内容，也可以封装扩展方法简化调用：

// 扩展方法封装
public static class PermissionTranslationExtensions
{
    public static string Translate(this string permissionKey, IStringLocalizer localizer)
    {
        return localizer[permissionKey];
    }
}

// 控制器调用示例
public class PermissionController : ControllerBase
{
    private readonly IStringLocalizer<PermissionClaims> _localizer;

    public PermissionController(IStringLocalizer<PermissionClaims> localizer)
    {
        _localizer = localizer;
    }

    public IActionResult GetUserPermissions()
    {
        // 从RBAC体系中拿到用户的权限标识列表
        var rawPermissions = new List<string> { "CanCreateUser", "CanUpdateUser" };
        // 批量翻译后返回给前端
        var result = rawPermissions.Select(p => new 
        {
            Key = p,
            DisplayName = p.Translate(_localizer)
        }).ToList();
        return Ok(result);
    }
}

如果你的场景不需要支持多语种动态切换，只需要固定把英文标识转成目标语言，也可以直接用静态字典存储映射关系，实现更简单：

public static class PermissionTranslationProvider
{
    private static readonly IReadOnlyDictionary<string, string> _arabicMappings = new Dictionary<string, string>
    {
        { "CanCreateUser", "اضافة مستخدم" },
        { "CanUpdateUser", "تعديل مستخدم" },
        // 剩余角色标识按规则补充即可
    };

    public static string GetArabicDisplayName(string permissionKey)
    {
        return _arabicMappings.TryGetValue(permissionKey, out var displayName) 
            ? displayName 
            : permissionKey; // 无匹配时返回原标识兜底
    }
}

选型建议 #

• 选内置本地化方案：需要支持多语种切换、后续有新增语种需求、权限标识会频繁更新的场景，维护资源文件不需要修改业务代码
• 选静态字典方案：仅单语种展示、权限标识数量少且长期不变的场景，无额外学习成本，实现速度更快

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