这次我们来看一个典型的 C# 跨平台移动开发实战项目一套围绕“智慧教育 App”展开的多项目企业级落地教程技术栈覆盖 C#、Xamarin 与 MAUI同时向下兼容 .NET 8 / .NET 9 体系。很多刚接触 C# 移动开发的读者会有两个疑问第一Xamarin 是不是已经过时了还有没有必要学第二MAUI 能不能直接接企业项目坑多不多。这套实战内容正好能回答这两个问题。从项目标题看它不是单纯讲语法而是把“智慧教育 App”作为业务载体走完从项目拆解、界面搭建、业务逻辑封装到接口联调、多项目发布的企业开发流程。核心价值在于用一套 C# 代码同时覆盖 Android、iOS并为后续扩展到 Windows、macOS 留好口子。尤其是对已经熟悉 WPF、WinForms、ASP.NET Core 的 C# 程序员来说转移动端时不再需要从头学 Kotlin 或 Swift这套路线的工作量曲线更平缓。本文不是照搬视频口播稿而是把它整理成一篇可以直接上手操作的 CSDN 技术文章。我会先列出这套项目的核心能力与硬件/软件门槛再给出开发环境的完整搭建方式然后带你把智慧教育 App 从解决方案结构、界面导航、业务模块测试到 API 批量同步整个跑一遍。文章最后会放一份常见的 MAUI/Xamarin 排查清单方便你在实际开发中快速定位问题。1. 核心能力速览能力项说明项目类型C# 跨平台移动应用实战源码 / 教程技术栈C#、Xamarin、MAUI、.NET 8 / .NET 9跨平台目标Android、iOS可扩展到 Windows、macOS核心业务场景智慧教育 App用户登录、课程浏览、学习记录、消息通知、数据统计多项目架构解决方案内拆分 UI 层、业务层、数据模型层、API 服务层开发工具Visual Studio 2022Windows/macOS启动方式通过 Visual Studio 启动 Android 模拟器 / iOS 模拟器 / Windows 桌面是否支持 API支持App 通过 HttpClient 调用 ASP.NET Core Web API是否支持批量任务支持学习记录、数据上报等可做批量同步与队列处理适合读者C# 开发者、Xamarin 学习者、MAUI 技术选型评估者、教育类 App 项目团队从材料看这套项目的主线是“手写”和“企业实战落地”所以它的侧重点不是某个炫酷的界面效果而是完整走过一个真实项目会遇到的模块拆分、接口联调、多平台编译和发布问题。有一点要提前说明Xamarin 与 MAUI 的关系不是替代后旧代码全部作废而是技术迭代。Xamarin.Forms 在 .NET 6 之后演化为 .NET MAUI如果项目标题里同时出现 Xamarin 和 MAUI更稳妥的理解是教程会先讲 Xamarin 时代积累的跨平台开发思路再落到 MAUI 的新工程结构上让从旧项目迁移的学习者也能对得上号。新项目选择技术栈时优先 MAUI维护存量 Xamarin 项目时需要熟悉 Xamarin 的启动流程和渲染机制。2. 适用场景与使用边界这套实战课程解决的是三类痛点第一类是 C# 程序员想进入移动开发但不想同时维护 Kotlin、Swift 两套代码。通过 Xamarin/MAUI业务代码用 C# 统一编写只在需要调原生功能时使用各平台的特定 API。第二类是团队已经用 ASP.NET Core 搭建了后端服务希望移动端能直接复用 DTO、枚举、校验逻辑等公共定义减少前后端类型不一致的问题。C# 前后端同语言至少在模型层能做到二进制或 NuGet 包级别共享这是不少小团队选择 C# 移动栈的现实理由。第三类是教育类应用的项目外包或独立开发者需要快速产出一个能演示的 App 原型又要留出后续扩展空间。智慧教育的典型模块比如课程列表、用户登录、学习进度同步用 MAUI 的一套 ViewModel 就能覆盖多个页面。不适合什么场景也要说清楚。如果团队里没有任何 C# 基础全部成员都是 Java/React Native 背景直接切到 C# 移动端的学习成本并不低。另外如果你的产品对 UI 的 iOS/Android 平台原生感要求极高每个交互都要跟系统控件深度保持一致MAUI 在当前版本的默认控件观感仍与原生存在差距需要投入额外的自定义渲染器或 Handler 工作。对这类需求Flutter、Kotlin Multiplatform 或双原生开发可能更合适。合规边界方面智慧教育 App 通常涉及学生、教师、家长三类人群的数据。未成年人信息属于敏感个人信息开发和测试时必须强调如下几点只在用户授权范围内采集数据且需要明确展示隐私政策。演示数据要用虚拟身份不能直接使用真实学校的学生姓名、照片、手机号。网络层必须启用 HTTPSToken 不能硬编码在 App 源码里。发布到应用商店前需要额外确认教育类目的资质要求和未成年人保护条款。涉及人脸识别、位置追踪、通信录访问时要严格限制在业务必要的范围内。所有功能演示都应默认关闭非必要权限。文中涉及的所有接口路径、App 名称均为示例实际项目请替换为正式域名和合规的部署环境。3. 开发环境准备与前置条件在开始创建 MAUI 项目前先检查一组硬性条件避免装完环境发现某个组件缺失。3.1 操作系统Windows 10 / 1164 位推荐 Windows 11。macOS 12 及以上如果要编译 iOS 应用并部署到真机需要 macOS Xcode。Android 和 Windows 桌面目标可以在 Windows 上直接开发调试。iOS 的模拟器运行需要 Mac这是 Apple 的签名和模拟器机制决定绕不开。3.2 Visual Studio 版本与工作负载Windows 上推荐 Visual Studio 202217.8 及更高版本安装时需要勾选以下工作负载ASP.NET 和 Web 开发.NET 跨平台开发包含 MAUI、Xamarin、Android SDK、Android 模拟器使用 .NET 的移动开发如果用的是命令行工具可以先用dotnet workload查看和安装 MAUI 工作负载。安装完成后用下面的命令检查 SDK 和工作负载状态dotnet --version dotnet workload list dotnet workload install maui-android maui-ios需要注意dotnet workload install需要管理员权限并且不同 .NET SDK 版本对应的工作负载清单版本不同。若机器上同时安装了 .NET 8 和 .NET 9建议先确认默认 SDK 版本dotnet --list-sdks然后通过global.json固定项目使用的 SDK 版本避免构建时误用更高版本。3.3 Android 开发依赖Android SDKVisual Studio 安装器会引导安装也可以在 Tools Options Xamarin Android Settings 中指定 SDK 路径。Android SDK 平台版本建议安装 Android 12API 31及其以上版本。MAUI 项目默认的 TargetFramework 会根据模板预设一个最低系统版本一般不需要手动创建太多 API 版本。Android 模拟器按需创建 Pixel 或 Nexus 虚拟设备。模拟器启动耗时会比真机调试久内存建议分配 2 GB 以上。3.4 iOS 开发依赖仅 macOS安装最新 Xcode并在终端执行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer sudo xcodebuild -license accept连接 Mac 后Visual Studio 会自动发现 Xcode 中的模拟器列表。3.5 磁盘空间与内存建议MAUI 项目的一次完整构建可能触发 NuGet 包还原和 Android 编译建议系统盘预留 20 GB 以上可用空间。内存方面若同时运行 Visual Studio、Android 模拟器和多个浏览器标签页16 GB 内存会更从容8 GB 内存也能开发但模拟器性能和热重载响应会有明显折扣。端口方面MAUI 开发默认使用随机端口但如果下载的示例代码里配置了固定端口或者需要连接本地 Web API建议提前检查端口占用netstat -ano | findstr :5xxx这里的 5xxx 需要替换为你实际要使用的 API 端口。4. 手写智慧教育 App 的解决方案结构所谓“多项目企业实战落地”核心在于解决方案不是一个大项目塞进所有代码而是拆分出清晰的分层结构。下面是一个可供参考的解决方案布局SmartEduSolution/ ├── SmartEdu.App/ # MAUI 客户端主项目 │ ├── Views/ # LoginPage、CourseListPage、StudyRecordPage │ ├── ViewModels/ # LoginViewModel、CourseViewModel │ ├── Services/ # ApiService、AuthService、SyncService │ ├── Models/ # 各平台通用的 DTO │ ├── Resources/ # 图标、字体、样式 │ ├── App.xaml │ ├── AppShell.xaml │ └── MauiProgram.cs ├── SmartEdu.Business/ # 业务逻辑类库 │ ├── Authentication/ │ ├── CourseScheduling/ │ └── StudyRecord/ ├── SmartEdu.Models/ # 共享数据模型类库 │ ├── CourseDto.cs │ ├── StudentDto.cs │ └── StudyRecordDto.cs ├── SmartEdu.Api/ # ASP.NET Core Web API 后端 │ ├── Controllers/ │ ├── Services/ │ └── appsettings.json └── SmartEdu.Tests/ # 单元测试 / 集成测试 ├── LoginServiceTests.cs └── CourseServiceTests.cs这种结构的优点很明显SmartEdu.Models可以被客户端、业务层、测试项目甚至后端 API 通过 NuGet 或项目引用方式共享而SmartEdu.Business不依赖 MAUI 的界面类型保证了可测试性。在 MAUI 项目里入口不再是传统 WinForms 的Program.cs里的 Main 函数而是MauiProgram.cs。下面是一个最小可运行的 MAUI 入口配置using Microsoft.Maui; using Microsoft.Maui.Hosting; using SmartEdu.App.Services; using SmartEdu.App.ViewModels; using SmartEdu.App.Views; namespace SmartEdu.App; public static class MauiProgram { public static MauiApp CreateMauiApp() { var builder MauiApp.CreateBuilder(); builder .UseMauiAppApp() .ConfigureFonts(fonts { fonts.AddFont(OpenSans-Regular.ttf, OpenSansRegular); fonts.AddFont(OpenSans-Semibold.ttf, OpenSansSemibold); }); builder.Services.AddSingletonApiService(); builder.Services.AddSingletonAuthService(); builder.Services.AddSingletonLoginViewModel(); builder.Services.AddSingletonCourseViewModel(); builder.Services.AddSingletonLoginPage(); builder.Services.AddSingletonCourseListPage(); return builder.Build(); } }依赖注入容器是 MAUI 内置的。所有页面、ViewModel、服务都通过builder.Services注册页面构造时自动解析依赖。这里的核心收益是单元测试时可以替换ApiService为 Mock 实现不需要依赖网络环境。App.xaml.cs在 MAUI 里负责启动 Shell 或首屏页面using SmartEdu.App.Views; namespace SmartEdu.App; public partial class App : Application { public App() { InitializeComponent(); MainPage new AppShell(); } }5. 安装部署与启动方式5.1 创建 MAUI 项目在 Visual Studio 中新建项目选择“ .NET MAUI App”模板。项目名建议使用SmartEdu.App解决方案名使用SmartEduSolution。模板会自动生成MainPage.xaml、AppShell.xaml和MauiProgram.cs。如果项目需要兼容 Xamarin.Forms 的旧结构也可以在创建项目时选择“ .NET MAUI App (Xamarin.Forms Compatible)”类型但新项目不建议刻意保留旧的 renderer 结构。5.2 配置多目标框架打开.csproj文件核心节点如下Project SdkMicrosoft.NET.Sdk PropertyGroup TargetFrameworksnet8.0-android;net8.0-ios/TargetFrameworks TargetFrameworks Condition$([MSBuild]::IsOSPlatform(windows))$(TargetFrameworks);net8.0-windows10.0.19041.0/TargetFrameworks OutputTypeExe/OutputType RootNamespaceSmartEdu.App/RootNamespace UseMauitrue/UseMaui SingleProjecttrue/SingleProject Nullableenable/Nullable /PropertyGroup ItemGroup PackageReference IncludeMicrosoft.Maui.Controls Version8.0.100 / PackageReference IncludeMicrosoft.Extensions.DependencyInjection Version8.0.100 / /ItemGroup /Project如果你已经切换到 .NET 9 SDK可以把net8.0-*替换为net9.0-*但要注意对应 MAUI 包版本是否存在以及 Android API 编译是否与 SDK 兼容。稳妥方式是在一个分支里先保留 net8.0验证完整运行后再升级 net9.0。5.3 启动 Android 模拟器在 Visual Studio 工具栏选择Android作为目标框架。打开“Android 设备管理器”创建一个模拟器。启动模拟器等待系统桌面完全加载。点击 F5 或“启动”按钮项目会自动构建 APK 并安装到模拟器。首次构建时间较长通常在 1 到 5 分钟之间取决于本机配置。可以观察底部输出窗口的日志出现Build succeeded后继续等待安装完成。5.4 Windows 桌面运行如果项目配置里包含net8.0-windows10.0.19041.0目标则可以直接在 Visual Studio 中选择Windows Machine启动。这样在开发调试阶段可以先用桌面窗口快速验证业务逻辑不需要频繁启动 Android 模拟器整体反馈速度会快很多。这种方式特别适合团队中没有 Android 真机、又想快速跑通 API 联调的情况。等 Windows 桌面版本稳定后再切回 Android 模拟器验证真实移动环境下的布局和触摸行为。6. 功能测试与效果验证下面以智慧教育 App 的四个典型模块为例给出功能测试的操作步骤和验收标准。6.1 用户登录模块测试目的验证用户名密码登录流程以及登录成功后 Token 的保存与跳转。操作步骤启动 App进入登录页。输入测试账号例如test-student-001密码输入Test2025。点击“登录”。观察页面是否跳转到课程列表页以及顶部是否显示当前用户名称。预期结果登录成功时控制台日志中可以看到接口返回200 OK。失败时页面出现错误提示不跳转。断网状态下页面展示“网络不可用请稍后重试”而不是静默卡死。判断标准Token 能被SecureStorage写读重启 App 后能自动恢复登录态退出登录后再次启动App 不会自动进入课程页。6.2 课程列表与课程详情测试目的验证课程分页加载、下拉刷新、课程详情页数据传递。操作步骤登录后进入“课程列表”页。向下滚动触发加载更多。点击任意课程卡片。进入详情页后点击“加入学习”。预期结果课程卡片展示封面、课程名称、讲师、章节数。分页加载时每页数量与后端 API 返回一致。详情页能正确接收课程 ID并调用详情接口。“加入学习”成功后按钮变为“继续学习”。判断方式抓取网络请求日志确认每一次滚动只触发一次分页请求没有重复请求。点击多个课程后返回列表滚动位置不丢失。6.3 学习记录与本地缓存测试目的验证离线状态下学习记录能先写入本地数据库联网后再同步。操作步骤开启飞行模式。在课程详情页播放视频停顿 1 分钟记录进度点。正常退出 App。关闭飞行模式重新打开 App。观察系统是否自动上传刚才的学习记录。预期结果本地 SQLite 数据库中能看到这条记录并且sync_status为Pending。重新联网后SyncService将Pending记录批量推送推送成功的记录改为Synced。如果 API 返回失败记录保持Pending状态并进入重试队列。这里要特别注意不要在演示时使用真实学生的姓名或学号。本地缓存表里建议只存业务 ID不存家庭成员姓名、手机号等敏感信息。所有的本地测试数据都使用虚拟 ID。6.4 消息通知模块测试目的验证站内消息和系统通知的联动。操作步骤用另一个账号向当前学生账号发送一条新消息。等待轮询或推送消息到达。点击系统通知栏的提醒跳转到消息详情页。预期结果未读消息数量角标更新。点击通知可跳转到对应会话页。已读状态与后端同步。若项目没有接入推送服务可以退化为轮询接口。轮询长连接或定时任务需要注意频率控制不能在 App 端使用 1 秒间隔的永久轮询建议使用 30 秒或更长间隔的页面活跃期轮询并在页面进入后台后停止定时器。7. 接口 API 调用与批量数据同步移动 App 几乎不会脱离后端独立运行。智慧教育项目的 API 层通常基于 ASP.NET Core 构建App 端通过 HttpClient 调用 REST 接口。7.1 API 服务启动后端项目可以是一个独立的 ASP.NET Core Web API 项目也可以与业务逻辑层放在同一个解决方案中。开发阶段常用两个方案本地直连http://localhost:5xxxApp 模拟器通过http://10.0.2.2:5xxx访问宿主机的 localhost。内网测试将 API 发布到局域网某个地址App 通过局域网 IP 访问但需要关闭防火墙或配置入站规则。7.2 HttpClient 封装示例下面这段代码展示在 MAUI 中封装 HTTP 请求重点在于统一处理 BaseUrl、Token 和 JSON 序列化using System.Net.Http; using System.Net.Http.Headers; using System.Text.Json; using SmartEdu.Models; namespace SmartEdu.App.Services; public class ApiService { private readonly HttpClient _httpClient; public ApiService() { _httpClient new HttpClient { BaseAddress new Uri(http://10.0.2.2:5210/) }; _httpClient.DefaultRequestHeaders.Accept.Add( new MediaTypeWithQualityHeaderValue(application/json)); } public async TaskListCourseDto GetCoursesAsync(string token, int page, int pageSize) { _httpClient.DefaultRequestHeaders.Authorization new AuthenticationHeaderValue(Bearer, token); var response await _httpClient.GetAsync($api/courses?page{page}pageSize{pageSize}); response.EnsureSuccessStatusCode(); var json await response.Content.ReadAsStringAsync(); return JsonSerializer.DeserializeListCourseDto( json, new JsonSerializerOptions { PropertyNameCaseInsensitive true }) ?? []; } }这段代码里已经包含了 Token 注入、GET 请求和 JSON 反序列化。注意在团队项目中不要把HttpClient每个页面都 new 一次应该注册为单例并复用。7.3 批量上报学习记录学习记录是教育 App 最容易产生批量数据的场景。一次课程学习可能产生多条学习片段每条包含开始时间、结束时间、进度百分比。逐条上报会产生大量请求需要按批次聚合。using System.Text; using System.Text.Json; using SmartEdu.Models; namespace SmartEdu.App.Services; public class SyncService { private readonly HttpClient _httpClient; public SyncService(HttpClient httpClient) { _httpClient httpClient; } public async Taskint SyncStudyRecordsAsync(IEnumerableStudyRecordDto records) { const int batchSize 50; var currentToken await GetAccessTokenAsync(); _httpClient.DefaultRequestHeaders.Authorization new System.Net.Http.Headers.AuthenticationHeaderValue(Bearer, currentToken); var totalSynced 0; records records.ToList(); foreach (var batch in records.Chunk(batchSize)) { var json JsonSerializer.Serialize(batch); var content new StringContent(json, Encoding.UTF8, application/json); var response await _httpClient.PostAsync(/api/study-records/batch, content); response.EnsureSuccessStatusCode(); var resultJson await response.Content.ReadAsStringAsync(); var result JsonSerializer.DeserializeBatchResult(resultJson); totalSynced result?.SyncedCount ?? 0; } return totalSynced; } private async Taskstring GetAccessTokenAsync() { // 实际项目应使用 SecureStorage 中的 Token。 // 如果 Token 过期需要先调用刷新接口再重试当前批次。 return await Task.FromResult(demo-token); } }批量任务的工程要点每批数据大小要限制在几十条范围内避免单次 JSON 过长。批任务必须有幂等策略新增指定recordId时支持去重。网络失败时当前批次整体回滚等待下一次定时器触发。同步队列可以基于 SQLite 表记录状态避免进程被杀后数据丢失。7.4 curl 方式验证接口在后端运行起来后可以使用 curl 快速验证接口是否畅通curl -X GET http://localhost:5210/api/courses?page1pageSize10 \ -H Authorization: Bearer YOUR_TOKEN curl -X POST http://localhost:5210/api/study-records/batch \ -H Content-Type: application/json \ -d [{courseId:1,progress:25,durationSeconds:100}]若接口返回 401检查 Token 是否有效。若返回 404检查 Controller 路由是否匹配api/[controller]。若返回 500需要去后端日志看异常堆栈常见是数据库连接字符串配置错误。8. 资源占用与性能观察MAUI 应用不是浏览器里跑网页它是有原生渲染壳的。但在调试阶段仍要关注几个容易拖慢体验的点。8.1 构建时间观察第一次创建 Android 目标时MSBuild 需要还原 MAUI 相关 NuGet 包并初始化 Android SDK 编译器。之后的增量构建通常能控制在 20 到 60 秒之间。如果发现每次改动 XAML 后构建时间都在 3 分钟以上大概率是以下问题同时打开了多个目标框架的构建。XAML 中使用了过多运行时解析的资源字典。Android 构建机器内存不足出现频繁 GC。Visual Studio 的 IntelliCode 和代码分析插件占用了大量 CPU。对应的优化策略是调试时只保留 Android 一个目标框架关闭不必要的代码分析规则把 XAML 中的静态尺寸改为相对单位并在条件编译时跳过不必要的加载。8.2 运行时内存MAUI 采用单项目模型页面和资源全部打包进主程序集。如果 App 页面数量很多但大部分页面不会同时打开建议使用 Shell 的 Tab 懒加载或者使用Routing.RegisterRoute注册需要跳转时才实例化的页面。观察内存可以使用 Visual Studio 自带的诊断工具或 Android Profiler。判断标准从课程列表页进入详情页再返回内存曲线应该保持平稳不能每次返回都增加明显内存且不回收。8.3 多平台差异同一套 XAML 在 Android、Windows、iOS 三个平台上渲染效果不完全一致尤其是字体行高、边距和弹出日期选择器。做功能验证时不建议只跑 Windows 桌面必须至少在 Android 模拟器中过一遍核心流程。降低差异的通用做法基础字体使用系统字体加上OnPlatform指定。固定宽高少写优先使用Grid加比例行/列。响应式布局要考虑平板和横屏。涉及安全区域的页面在 iOS 上用SafeAreaInset在 Android 侧写WindowInsets适配。9. 常见问题与排查方法问题现象可能原因排查方式解决方案新建 MAUI 项目后无法编译缺少 MAUI 工作负载或 SDK 版本与项目不匹配dotnet workload list查看工作负载安装对应的maui-android/maui-ios工作负载或升级 Visual Studio 到 17.6XAML 编译时报Resource does not exist资源字典 Key 写错或 x:Name 引用顺序不对查看具体行号检查资源是否放在App.Resources或页面ResourceDictionary中统一资源 Key 命名避免多个页面使用相同 Key 但类型不同Android 模拟器启动后 App 一直白屏部署时间过长或入口页面的 ViewModel 在构造函数中执行了耗时操作查看系统日志和 MAUI 日志窗口把耗时操作移入OnAppearing或异步初始化任务中App 能访问网页但无法访问本地 API模拟器不能直接使用localhost在模拟器的浏览器中尝试打开http://10.0.2.2:5210将 API 地址改为http://10.0.2.2:5210真机调试时改为局域网 IP 或通过 adb 反向代理API 返回 401App 没有跳转登录页Token 过期或未写入当前请求头在ApiService中添加日志打印当前 Token 的前几位增加 Token 刷新机制401 时统一进入重新登录流程批量同步时数据库锁死SQLite 写入与读操作并发冲突查看 SQLite 错误日志确认是否有多个线程写同一条记录使用单一DatabaseAsync实例所有写操作排队执行避免跨线程并发写发布时找不到 Android 签名文件Keystore 路径不存在或密码写错检查.csproj中AndroidSigningKeyStore属性使用.keystore文件并保存密码到~/.gradle或本地安全配置中iOS 目标在 Visual Studio for Windows 不可见生成 iOS 应用需要连接 Mac检查远程 Mac 配对状态在Tools Options Xamarin iOS Settings中配置 Mac 地址App 启动时间明显偏长启动页加载资源过多首次启动 JIT用 Performance Profiler 查看启动方法耗时把不需要立即加载的模块改为按需注册字体和图片资源延迟加载这套排查方式不只适用于智慧教育 App任意 MAUI / Xamarin 跨平台项目都能直接套用。重点在于先确认是环境问题、代码问题还是网络问题再决定修改方向不要每次遇到 XAML 加载异常都先删 bin/obj。10. 最佳实践与使用建议10.1 分层隔离界面层不直接访问数据库在示例解决方案中SmartEdu.App只负责页面和 ViewModel。任何数据库读写、文件解析、网络请求都要通过Services层进入。这样做的直接回报是后端的接口改版时只需要修改一个ApiService新来的同事即使不懂 MAUI 页面机制也能在SmartEdu.Business中阅读业务逻辑并补充单元测试。10.2 MVVM 模式下要控制 ViewModel 生命周期页面OnAppearing中触发数据加载时需要警惕页面销毁后异步方法继续执行。建议使用CancellationTokenSource并在页面卸载时取消public partial class CourseListPage : ContentPage { private readonly CourseViewModel _viewModel; private CancellationTokenSource? _cts; public CourseListPage(CourseViewModel viewModel) { InitializeComponent(); _viewModel viewModel; BindingContext _viewModel; } protected override void OnAppearing() { base.OnAppearing(); _cts new CancellationTokenSource(); _ _viewModel.LoadCoursesAsync(_cts.Token); } protected override void OnDisappearing() { _cts?.Cancel(); base.OnDisappearing(); } }这样在网络请求尚未完成时离开页面就不会在返回页面后被过期的回调更新界面状态。10.3 本地数据缓存离线场景是移动 App 的刚需。在 MAUI 中推荐使用sqlite-net-pcl或 EF Core 的 SQLite Provider。缓存表结构建议增加updated_at、sync_status、is_deleted三个字段确保后续批量同步可以增量处理public class StudyRecordLocal { [PrimaryKey, AutoIncrement] public int Id { get; set; } public string CourseId { get; set; } string.Empty; public int Progress { get; set; } public DateTime UpdatedAt { get; set; } public string SyncStatus { get; set; } Pending; }10.4 网络安全与合规任何智慧教育类 App 都不能把 Token 写在AppSettings明文文件里。Token 应当存放在SecureStorage或系统钥匙串中。演示项目里也不要提交包含真实域名、真实用户名的配置文件。10.5 批量任务日志同步、数据导入等场景要留下可检索的日志。建议每次批量任务记录任务开始时间与结束时间总记录数、成功数、失败数失败记录对应的 ID 列表异常类型与堆栈摘要下一次重试计划时间有了这些日志线上反馈“某学生记录没同步”时才能快速排查。11. 总结与下一步这套 C# Xamarin / MAUI 的智慧教育 App 实战项目最值得尝试的是“多项目企业级落地”的工程组织方式。界面代码只是表面真正的价值在于App、业务逻辑、数据模型、API、测试五个项目如何在一个解决方案里协作既有清晰的依赖方向又能让 C# 程序员用一套技能栈完成跨平台开发。拿到源码后建议按下面的顺序验证先编译并运行默认模板确认 MAUI 环境没有隐藏问题。再跑通登录 课程列表 学习记录本地缓存三条核心链路确认网络层和数据库层稳定。然后再开启同步服务模拟弱网和断网场景观察批量任务是否可靠。最容易踩的坑有三个Android 模拟器访问宿主机 localhost 的地址写错批量同步没有做幂等导致重复数据iOS 构建依赖 Mac 导致 Windows 环境下一开始无法完整验证三端。提前接受这三个限制整个项目的推进会顺畅很多。后续可以继续扩展的方向也比较明确在 MAUI 项目中接入消息推送、视频播放、在线文档预览把后端 API 从单体拆成微服务并在新版本中增加 .NET 9 的跨平台优化在SmartEdu.Tests中补全集成测试让每一次接口变更都有自动化兜底。对想长期走 C# 跨平台路线的团队来说这类从教育业务场景切入的实战源码是比零散教程更值得花时间研究的起点。建议收藏备用也欢迎把你在部署或联调中踩到的其他问题带回评论区一起排查。