C# MAUI怎么做国际化 MAUI多语言支持教程_网络技术

发布时间 - 2025-12-27 00:00:00 点击率：次

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

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

在 MAUI 项目中新建 Resources 文件夹（推荐），然后添加默认资源文件和对应语言的本地化版本：

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

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

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