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

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 设置时机 —— 这两点错一个,多语言就静默失效。










