feat: add qa modules (#50)

Author: Charliechen114514

document/index.md

@@ -44,4 +44,8 @@ features:
     title: 实战演练
     details: 完整系统构建与调试，从零到一的嵌入式项目实战
     link: /tutorial/practical/
+  - icon: ❓
+    title: 常见问题
+    details: 收录 Issue 答疑记录，快速解决常见问题
+    link: /qa/
 ---

document/qa/index.md

@@ -0,0 +1,13 @@
+<PageHeader icon="❓" title="Issue 答疑记录" description="收录 GitHub Issue 中有价值的问答内容" />
+
+## 答疑列表
+
+这里记录了项目开发过程中用户提出的常见问题及其解答，内容来源于真实的 GitHub Issue 交流。
+
+<ChapterNav>
+  <ChapterLink num="31" href="qa_31">Docker 构建镜像更新相关疑问</ChapterLink>
+</ChapterNav>
+
+::: tip 有问题？
+提交 [GitHub Issue](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues) 获取帮助。
+:::

document/qa/qa_31.md

@@ -0,0 +1,66 @@
+<PageHeader icon="❓" title="Issue #31: Docker 构建镜像更新相关疑问" description="关于 Docker 环境构建和 SDK 版本的问答" />
+
+**原文链接**: [GitHub Issue #31](https://github.com/Awesome-Embedded-Learning-Studio/imx-forge/issues/31)
+
+> 请注意Issue的时间和时效性！如果存在行为变化，但是本文档没有反馈Update行为，欢迎Issue我们！我们会持续收录可能会对其他朋友有所帮助的Issue!
+
+---
+
+## Q1: docker compose 命令失败
+
+**问题**：尝试使用 `docker compose up -d --build` 构建环境时出现错误。
+
+**解答**：本项目未配置 docker compose，不支持该命令。请使用以下命令构建：
+
+```bash
+DOCKER_BUILDKIT=1 docker build -t imx-forge:latest .
+```
+
+---
+
+## Q2: DOCKER_BUILDKIT=1 会完全重建镜像吗？
+
+**问题**：每次运行 `DOCKER_BUILDKIT=1 docker build` 都会完全重新构建整个镜像吗？
+
+**解答**：不会。`DOCKER_BUILDKIT=1` 启用的是新版 BuildKit 构建系统，支持增量构建和缓存机制，不会每次都完全重建镜像。只有在 Dockerfile 或源文件发生变化时才会重新构建相关层。
+
+---
+
+## Q3: 编译器下载非常慢
+
+**问题**：第一次构建和重新构建镜像时都会卡在编译器下载步骤，下载速度很慢。
+
+**解答**：这通常是网络问题导致。可能的原因：
+- 编译器服务器在国内访问不稳定
+- 需要使用代理加速下载
+
+**已经改进**
+1. 移除 Dockerfile 中的 `wget -q` 参数，显示详细下载信息，提升可调试性(目前已经做到，如果您发现)
+
+**计划改进**：
+1. 预构建 Docker 镜像并上传到 Docker Hub，用户可以直接拉取现成镜像开始开发。目前还是托管到Github的，如果的确存在需求，提出Issue让我们知道，并且为您的需求进行开发！
+
+---
+
+## Q4: Docker 镜像和官方 SDK 的区别是什么？
+
+**问题**：本项目的 Docker 镜像与开发板厂商（如正点原子）提供的 SDK 有什么区别？
+
+**解答**：以下是正点原子官方 SDK 与 imx-forge 的版本对比：
+
+| 组件 | 正点原子 | imx-forge |
+|------|---------|-----------|
+| U-Boot | 2016 | 2025 |
+| 内核 | 4.1.15 | 6.12.49 / 7.0-RC4 |
+| BusyBox | 1.32 | 1.37 |
+| 编译器 (GCC) | Linaro GCC 8.x | GCC 15.2.1 |
+| Qt | Qt 5.12 | Qt 6.9 |
+
+imx-forge 使用更新的软件版本，提供更现代的开发环境。
+
+---
+
+## 相关链接
+
+- [Docker 环境搭建教程](/tutorial/docker/)
+- [快速开始指南](/QUICK_START)