《Getting Started with Flutter》读者视角问题清单

检查时间：2026-06-04

检查范围：content/courses/en/flutter 下的课程入口、章节索引和主要 MDX 课文。以下问题从读者学习体验出发整理，优先级越高，越可能直接导致读者中断阅读、误解知识或不信任课程。

P0：会直接阻断学习的问题

4 个正文页接近空骨架，读者点进去没有可学习内容

受影响文件：

• content/courses/en/flutter/01-dart-basics.mdx
• content/courses/en/flutter/02-flutter-widgets.mdx
• content/courses/en/flutter/03-advanced-topics.mdx
• content/courses/en/flutter/03-state-management.mdx

这些页面基本只剩 frontmatter、标题、组件或极少量说明，无法承接课程路径。读者会以为内容未完成，尤其当它们出现在章节中部时，会直接中断学习。

建议：补齐正文、例题、阶段小结和必要图示；若短期无法补齐，先从导航中隐藏或标注为未完成。

1 个页面存在占位或待办残留

受影响文件：

• content/courses/en/flutter/index.mdx

这些占位文本、TODO 或外部 placeholder 图片会让课程显得未交付，也可能导致图片加载失败。

建议：替换为真实正文、本地图片或明确的课程说明；不要让 placeholder 进入正式阅读路径。

P1：结构和学习路径问题

4 个页面元数据不完整

受影响文件：

• content/courses/en/flutter/01-dart-basics.mdx
• content/courses/en/flutter/02-flutter-widgets.mdx
• content/courses/en/flutter/03-advanced-topics.mdx
• content/courses/en/flutter/03-state-management.mdx

缺少 title、课程/章节 description 或正文页 order 会影响导航、SEO、排序和卡片摘要。

建议：补齐标题、描述和排序字段，并确保同一目录下的排序规则稳定。

P2：阅读体验问题

暂未发现明显的阅读体验 P2 问题。

建议修复顺序

1. 补齐或隐藏空骨架正文页。
2. 清理占位文本、TODO 和 placeholder 图片。