C# MAUI怎么做国际化 MAUI多语言支持教程

10次阅读

MAUI 国际化通过。resx 资源文件、Culture 切换和 XAML 绑定实现,需设 Build Action 为 Embedded Resource、严格命名、在 MauiProgram 中预设 Culture,并用 OnPropertyChanged 刷新绑定。

C# MAUI 怎么做国际化 MAUI 多语言支持教程

MAUI 的国际化主要靠 资源文件(.resx)+ Culture 切换 + 绑定支持 实现,不依赖第三方库也能完成基础 多语言 切换,关键是把资源管理好、Culture 设置对、XAML 中用对绑定方式。

准备多语言资源文件

在 MAUI 项目中新建 Resources 文件夹(推荐),然后添加默认资源文件和对应语言的 本地化 版本:

  • AppResources.resx —— 默认语言(如中文简体),放在 Resources 文件夹下
  • AppResources.zh-Hans.resx —— 中文简体(可选,与默认一致时可省略)
  • AppResources.en-US.resx —— 英文美国
  • AppResources.es-ES.resx —— 西班牙语西班牙

注意:所有 .resx 文件的 Build Action 必须设为 “Embedded Resource”;文件名必须严格匹配 基名。 区域名。resx 格式;Visual Studio 会自动生成强类型类 AppResources,供 C# 和 XAML 使用。

在 XAML 中使用本地化字符串

MAUI 支持直接在 XAML 中通过静态资源引用 AppResources 类的属性:

  • 先在 XAML 根节点添加命名空间:xmlns:resources="clr-namespace:YourApp.Resources"
  • 然后这样写文本:Text="{x:Static resources:AppResources.LoginButton}"
  • 按钮 / 标签等控件都适用,无需额外代码

⚠️ 注意:XAML 不支持动态刷新(比如切语言后界面不会自动 重绘),需要手动触发或配合 MVVM 重绑定(见下一条)。

运行时切换语言并刷新界面

切换语言本质是设置当前线程的 CultureInfo,再通知 UI 重新加载资源。关键三步:

  • 设置 Thread.CurrentThread.CurrentCulture.CurrentUICulture
  • 调用 ResourceManager.Current.ChangeCulture(newCulture)(MAUI 7+ 自动支持)
  • 刷新当前页面:可 Navigation.PopAsync()PushAsync(new MainPage()),或更轻量地——
    在 ViewModel 中用 OnPropertyChanged(nameof(LocalizedText)) 触发绑定更新(需将资源访问封装为属性)

示例(ViewModel 中):

private string _greeting; public string Greeting => AppResources.HelloWorld; // 直接读取,但不会自动更新

改成可通知的写法:

public string Greeting => AppResources.HelloWorld; // 切语言后调用:OnPropertyChanged(nameof(Greeting));

进阶:自动识别系统语言 + 持久化用户选择

首次启动时读系统语言:

  • Thread.CurrentThread.CurrentUICulture.Name 获取当前 UI 区域名
  • 或跨平台更稳的方式:Microsoft.Maui.Devices.DeviceInfo.Platform + 平台特定代码(如 Android 的 Java.Util.Locale.Default

保存用户选择:

  • Preferences.Set("LanguageCode", "en-US") 记录偏好
  • 下次启动时读取并提前设置 Thread.CurrentThread.CurrentUICulture,最好在 MauiProgram.CreateMauiApp() 之后、MainWindow 创建前完成

基本上就这些。不复杂但容易忽略 Build Action 和 Culture 设置时机 —— 这两点错一个,多语言就静默失效。

text=ZqhQzanResources