C#怎么实现多语言国际化_C#如何使用资源文件实现切中英文【指南】

穿越時空

穿越時空

2026-03-27

786人浏览

原创

资源文件命名须严格匹配标准文化标识,如resources.zh-cn.resx;切换语言需重设currentuiculture并手动刷新界面;key区分大小写且禁用空格;卫星程序集发布时需启用publishincludesatelliteassemblies。

c#怎么实现多语言国际化_c#如何使用资源文件实现切中英文【指南】

资源文件命名必须严格匹配文化标识

Visual Studio 里右键项目 → “添加” → “新建项” → 选“资源文件”,名字不能随便起。Resources.resx 是默认中性资源,Resources.zh-CN.resxResources.en-US.resx 才会被自动识别为对应语言变体。如果写成 Resources_zh.resxResources.en.resx,运行时 ResourceManager 就找不到——它只认标准文化名(culture name),不接受自定义缩写。

常见错误现象:MissingManifestResourceException 或取到的字符串始终是默认语言(比如总显示中文,切英文没反应)。

  • 确保所有资源文件名以 Resources. 开头 + 标准文化代码 + .resx
  • 文化代码用 zh-CN 不用 zh,用 en-US 不用 en(除非你明确只支持通用英语且已设 CultureInfo.DefaultThreadCurrentUICulture = new CultureInfo("en")
  • 编译后检查输出目录:zh-CN\Resources.resourcesen-US\Resources.resources 应该真实存在子文件夹中

运行时切换语言要重设 CurrentUICulture 并重建 UI

Thread.CurrentThread.CurrentUICulture 决定 ResourceManager 查哪套资源,但它不会自动刷新已有控件的文本。WinForms 里改完文化后,得手动触发界面更新;WPF 更麻烦,绑定不会自动响应文化变更。

使用场景:用户点“切换英文”按钮后,菜单、标签、提示文字都要立刻变。

  • 切换前先保存原文化:var old = Thread.CurrentThread.CurrentUICulture
  • 切换后立即赋值:Thread.CurrentThread.CurrentUICulture = new CultureInfo("en-US")
  • WinForms:调用 this.ApplyResources(null, null) 或逐个重设控件 Text 属性(推荐封装一个 RefreshLocalizedText() 方法)
  • WPF:没有内置刷新机制,需重新绑定或用 Language 属性配合 x:Uid + MSBuild 生成的 BAML 资源(实际项目中多数人选择重启窗口或重载 ViewModel)

ResourceManager.GetString() 的 key 区分大小写且不能含空格

资源文件里每个字符串都有一个 key,GetString("SaveButton_Text") 能取到,但 GetString("savebutton_text")GetString("Save Button Text") 会返回 null —— 它底层用的是哈希查找,且设计器生成的 .resources 文件对 key 是严格大小写敏感的。

C函数速查手册(CHM版)
C函数速查手册(CHM版)

C函数速查手册(CHM版)

下载

性能影响:key 错误导致反复返回 null 后又 fallback 到默认资源,看似没报错,实则埋下逻辑隐患(比如某按钮文案始终不更新)。

  • 统一用 PascalCase 命名 key,如 LoginForm_TitleConfirmDialog_OK
  • 避免在 key 里用连字符、空格、中文,VS 资源编辑器虽允许输入,但生成的 .Designer.cs 可能出问题
  • 调试时可临时加断点检查 rm.GetResourceSet(CultureInfo.CurrentUICulture, true, true) 返回的集合,确认 key 是否真存在

发布时别漏掉卫星程序集

发布 .NET Framework 或 .NET 5+ 自包含部署时,zh-CNen-US 文件夹必须随主程序一起拷贝。如果只复制了 MyApp.exeMyApp.dll,那无论怎么设文化,都只能回退到中性资源。

容易踩的坑:用 dotnet publish -c Release -r win-x64 默认不会把卫星程序集放进 publish/ 目录,除非你在 csproj 里显式开启:

<propertygroup><publishtrimmed>false</publishtrimmed><publishreadytorun>true</publishreadytorun><publishincludesatelliteassemblies>true</publishincludesatelliteassemblies></propertygroup>

另外,IIS 或 Windows 服务环境下,CurrentUICulture 可能被宿主重置,建议在入口处(如 Main()Application_Start)强制初始化一次。

最常被忽略的一点:资源文件的“生成操作”属性必须是 Embedded Resource,不是 ContentNone——否则编译器根本不会把它打包进程序集或卫星程序集。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

528

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

1181

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

556

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

1051

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

149

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

203

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

526

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

138

20

resource是什么文件
resource是什么文件

Resource文件是一种特殊类型的文件,它通常用于存储应用程序或操作系统中的各种资源信息。它们在应用程序开发中起着关键作用,并在跨平台开发和国际化方面提供支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.20

276

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RabbitMQ 教程手册
RabbitMQ 教程手册

共0课时 | 0人学习

Linux man-pages 项目
Linux man-pages 项目

共0课时 | 0人学习

C# 教程
C# 教程

共94课时 | 20.2万人学习