教程加载慢或失败 — 网络、存储、版本三大原因排查

教程加载为什么需要网络

ArtWorkout 的课程是云端加载的——引导线数据、配色方案、课程预览图等都存在服务器上。你选择一门课程后，App 才从服务器拉取这些数据到本地缓存，然后显示在画板上。

这种设计的好处是：

代价是：每门课第一次打开需要联网加载。网络状况直接影响加载速度。

解决：切换网络环境——Wi-Fi 和移动数据互相切换试试。如果都慢，可能是 ArtWorkout 服务器在你所在地区的节点延迟高（比如中国用户连到北美服务器）。

ArtWorkout 的课程缓存需要写入本地存储。如果设备存储空间满了或只剩很少（<100MB），加载会明显变慢甚至失败。

解决：清理设备存储空间——删除不用的 App、清理照片/视频、清理其他应用的缓存。建议至少留出 500MB 空间。

刚刚上线的新课可能在服务器上还没有足够的 CDN 缓存节点，或者太多人同时在加载，服务器压力大。

解决：等 24-48 小时再试——CDN 会逐步缓存到全球各节点，之后加载就快了。

Advanced 级别的长课程（25-30 步）的引导线数据量比 Beginner 大 2-3 倍。如果网络本来就不太好，加载大课程更容易卡。

解决：先画 Beginner 或 Intermediate 的短课程，网络好的时候再加载长课程。

旧版本的 App 可能有缓存逻辑 Bug 或服务器接口不兼容。

解决：更新 App 到最新版本。

如果某门课你之前加载过、突然开始报错误，可能是本地缓存的数据损坏了。

解决：清除 App 缓存——设置 → 应用管理 → ArtWorkout → 清除缓存。清除后需要重新加载所有课程，但能解决大部分数据损坏问题。

罕见情况——ArtWorkout 的某个区域服务器挂了或正在维护。

判断方法：App 内有没有维护通知？社区（Discord/Telegram）里有没有其他用户也说加载不了？

解决：这种情况用户侧没什么能做的，只能等官方修复（通常几小时内）。

加载到一半网络突然断了，部分引导线数据没下载完整，渲染出来就是乱的。

解决：退出这门课，重新进入——让它完整加载一次。

极少数情况下，自定义的高 DPI 或缩放设置可能导致引导线渲染错位。

解决：把屏幕缩放恢复到默认值（100%），或者在 ArtWorkout 设置里调画板分辨率。

PRO 会员可以把课程下载到本地，之后不需要网络也能画。

使用方法：在课程详情页点击"下载"按钮（需要 PRO 权限）。下载后的课程会存在设备本地，离线也能完整加载和使用。

好处：

限制：设备存储空间有限（每个课程约 1-5MB），下载多了要注意清理旧课程。