在 .NET MAUI 中配置依赖注入：服务注册…

当需要在 .NET MAUI 应用的 MauiProgram.cs 中注册服务、ViewModel 和 Page，并选择正确的生命周期（Singleton/Transient/Scoped）时使用。

适用场景

解决思路

1. 识别所有需要参与依赖注入的服务、ViewModel 和 Page。
2. 为每个类型选择正确的生命周期：共享服务用 AddSingleton，Page 和 ViewModel 用 AddTransient。
3. 在 MauiProgram.CreateMauiApp() 中通过 builder.Services 注册所有类型，按类别分组（服务、HTTP、ViewModel、Page）。
4. 在 AppShell.xaml.cs 中把 Page 注册为 Shell 路由，使 Shell 导航能自动解析完整依赖图。
5. 通过构造函数注入把 ViewModel 注入 Page，并将 ViewModel 赋给 BindingContext。
6. 用 #if 指令添加平台特定注册，确保覆盖每个目标平台或提供回退实现。
7. 运行应用验证解析正常，确认运行时没有 null 依赖或缺少注册的异常。
8. 生命周期选择：AddSingleton<T>() 用于共享状态、创建开销大、应用级配置（如 HttpClient 工厂、设置服务、数据库连接）；AddTransient<T>() 用于轻量、无状态或每次使用都需要新实例的类型（Page、ViewModel、每次调用的 API 包装器）；AddScoped<T>() 用于按窗口生命周期或手动创建的 IServiceScope（在 MAUI 中很少用）。
9. 默认把 Page 和 ViewModel 注册为 Transient，把共享服务注册为 Singleton。
10. 避免使用 AddScoped，除非手动管理 IServiceScope：MAUI 没有像 ASP.NET Core 那样的内置请求作用域；MAUI 每个窗口创建一个 IServiceScope，Scoped 服务随该窗口存活，而从根提供程序解析时它表现得像 Singleton，两者都无法提供每次导航的新鲜实例。
11. 在 MauiProgram.cs 中注册：服务用 AddSingleton<IDataService, DataService>()、AddSingleton<ISettingsService, SettingsService>()；HTTP 用 AddHttpClient<IApiClient, ApiClient>()（需要 NuGet 包 Microsoft.Extensions.Http）；ViewModel 用 AddTransient<MainViewModel>()、AddTransient<DetailViewModel>()；Page 用 AddTransient<MainPage>()、AddTransient<DetailPage>()。
12. 通过构造函数参数注入依赖，容器在类型本身从 DI 解析时会自动解析这些依赖。
13. ViewModel 到 Page 的接线：同时注册 Page 和 ViewModel，把 ViewModel 注入 Page 并赋给 BindingContext。
14. Shell 导航自动解析：当 Page 既在 DI 中注册又注册为 Shell 路由时，Shell 在导航时自动解析它及其完整依赖图；用 Routing.RegisterRoute(nameof(DetailPage), typeof(DetailPage)) 注册路由，再用 await Shell.Current.GoToAsync(nameof(DetailPage)) 导航。
15. 向 DI 解析的 ViewModel 传参：DI 提供 ViewModel 的依赖，导航参数单独到达；不要在构造函数中注入它们，而是在 ViewModel 上实现 IQueryAttributable 以同时接收两者；Shell 会把查询属性应用到 Page 及其 BindingContext，ViewModel 无需在 Page 中做任何接线即可收到。
16. 平台特定注册：用预处理器指令注册平台实现，始终覆盖每个目标平台或提供 no-op 回退以避免运行时 null，例如 #if ANDROID / #elif IOS || MACCATALYST / #elif WINDOWS / #else 分支。
17. 显式解析（最后手段）：优先构造函数注入；仅在注入确实不可用时（自定义 handler、平台回调）使用，例如 this.Handler.MauiContext.Services.GetService<IDataService>()；需要动态解析时注入 IServiceProvider，例如用 serviceProvider.GetRequiredService<T>() 解析 Page。
18. 接口优先模式以便测试：为每个服务定义接口，使实现可在测试中替换；生产注册用 AddSingleton<IDataService, DataService>()，测试注册用 services.AddSingleton<IDataService, FakeDataService>()。
19. 避免 Singleton ViewModel 导致数据陈旧：用 AddTransient<DetailViewModel>() 而非 AddSingleton<DetailViewModel>()。
20. 注意 ContentTemplate 中的 Page 不经过 DI 创建：通过 <ShellContent ContentTemplate="{DataTemplate views:DetailPage}"> 声明的 Page 用 Activator.CreateInstance 实例化，构造函数注入不会运行，若 Page 唯一构造函数带依赖会抛 MissingMethodException；通过 Routing.RegisterRoute + GoToAsync 到达的 Page 走 ActivatorUtilities.GetServiceOrCreateInstance，即使 Page 类型未注册也会注入已注册依赖，无法解析必需依赖时会抛异常；同时注册 Page 及其依赖可让两条路径都正常工作；若需要为 tab/flyout 页面使用 DI，给它一个无参构造函数自行解析所需内容，或用路由导航而不是嵌入 ContentTemplate。
21. 注意 XAML 资源解析与 DI 时序：App.xaml 中的 XAML 资源在 InitializeComponent() 期间解析，此时容器尚未完全可用；把依赖服务的工作推迟到 CreateWindow()，例如在 App 构造函数中保存 IServiceProvider，在 CreateWindow 中用 _services.GetRequiredService<AppShell>() 创建 Window（需要在 MauiProgram.cs 中注册 builder.Services.AddTransient<AppShell>()）。
22. 避免服务定位器反模式：不要用 this.Handler.MauiContext.Services.GetService<IDataService>()，改用构造函数注入使依赖显式且可测试。
23. 避免条件注册中遗漏平台：在 #if 块中忘记某个平台会导致该平台上 GetService<T>() 返回 null；始终包含 #else 回退或覆盖每个目标。
24. 避免在没有手动作用域的情况下使用 AddScoped：AddScoped 要么给窗口生命周期要么表现为 Singleton，永远不会提供每次导航的新鲜实例；除非显式创建并管理 IServiceScope，否则用 AddTransient 或 AddSingleton。
25. 回答要窄但完整：推荐生命周期变更时展示注册代码，并给出实际可行的替代方案而非单一结论；对于 unit-of-work 或 DbContext 问题，应同时给出 AddTransient、显式 IServiceScopeFactory.CreateScope() 和工厂模式（AddDbContextFactory），并说明各自适用场景。
26. 不要向未使用 DI 的项目引入 DI，不要替换可用的服务生命周期，也不要仅为对称性添加接口——只在用户要求或修复真实缺陷时这样做。

适用边界 · 注意事项

• XAML 数据绑定语法或编译绑定——使用 maui-data-binding 技能。
• Shell 路由注册和查询参数——使用 maui-shell-navigation 技能。
• Mock 框架或测试运行器——使用标准 .NET 测试工具（xUnit、NUnit、MSTest）和 mock 库（NSubstitute、Moq）。