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

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