ABP Framework Blazor Server：如何修改模块与UI本地化文本？

算力阿峰

2026-7-26

修改ABP Framework Blazor Server应用的本地化文本（如“Sign Out”改为“Sign-Out”）

ABP的UI文本（包括框架自带的“Sign Out”、管理模块相关文本）都封装在NuGet包中，项目里不会直接看到源码中的本地化文件，你需要通过本地化覆盖机制来修改：

步骤1：在项目中添加对应资源的本地化文件
找到你的Blazor Server项目（通常命名为xxx.Blazor.Server），在Localization目录下创建对应资源的子目录：
- 要修改框架UI文本（如Sign Out），创建Localization/AbpUi/en.json
- 要修改管理模块（如Identity、租户管理）文本，创建对应资源的目录，比如Localization/AbpIdentity/en.json（对应身份管理模块）
步骤2：编写需要覆盖的键值对
无需复制框架所有本地化内容，只添加你要修改的条目即可。比如修改“Sign Out”为“Sign-Out”，在AbpUi/en.json中写入：
```
{
  "culture": "en",
  "texts": {
    "AbpUi::SignOut": "Sign-Out"
  }
}
```
管理模块文本同理，比如修改身份模块的“Users”文本，在AbpIdentity/en.json中添加对应键值对：
```
{
  "culture": "en",
  "texts": {
    "AbpIdentity::Users": "User List"
  }
}
```
提示：如果不知道文本对应的键名，可以通过浏览器调试查看元素的本地化绑定，或者参考框架源码中的本地化资源文件找到对应键

步骤3：确认本地化配置（可选）
多数ABP模板项目已默认配置了本地化扫描，但如果修改不生效，可以在项目模块类的ConfigureServices方法中手动注册你的本地化文件路径：

Configure<AbpLocalizationOptions>(options =>
{
    options.Resources
        .Get<AbpUiResource>()
        .AddJsonPath("Localization/AbpUi");

    options.Resources
        .Get<AbpIdentityResource>()
        .AddJsonPath("Localization/AbpIdentity");
});