From aa0a9f7ab609788c8ef46c6a58dd650dbaac5fff Mon Sep 17 00:00:00 2001
From: GeWuYou <95328647+GeWuYou@users.noreply.github.com>
Date: Thu, 12 Feb 2026 01:24:55 +0800
Subject: [PATCH] =?UTF-8?q?docs(tutorials):=20=E6=B7=BB=E5=8A=A0=E6=95=99?=
 =?UTF-8?q?=E7=A8=8B=E6=A6=82=E8=A7=88=E9=A1=B5=E9=9D=A2=E5=B9=B6=E8=B0=83?=
 =?UTF-8?q?=E6=95=B4=E5=AF=BC=E8=88=AA=E9=93=BE=E6=8E=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 创建了新的教程概览页面 docs/zh-CN/tutorials/index.md
- 添加了完整的教程目录结构和学习路径介绍
- 在侧边栏中增加了教程概览链接
- 修正了教程导航链接指向正确的根目录
- 包含了基础教程、Godot集成教程和高级模式教程的详细介绍
- 提供了三种不同的学习路径建议和前置知识要求
---
 docs/.vitepress/config.mts    |   3 +-
 docs/zh-CN/tutorials/index.md | 204 ++++++++++++++++++++++++++++++++++
 2 files changed, 206 insertions(+), 1 deletion(-)
 create mode 100644 docs/zh-CN/tutorials/index.md

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index f6cd578..5cc590a 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -50,7 +50,7 @@ export default defineConfig({
           { text: 'Game', link: '/zh-CN/game/' },
           { text: 'Godot', link: '/zh-CN/godot/' },
           { text: '源码生成器', link: '/zh-CN/source-generators' },
-          { text: '教程', link: '/zh-CN/tutorials/basic' },
+          { text: '教程', link: '/zh-CN/tutorials/' },
         ],
 
         sidebar: {
@@ -139,6 +139,7 @@ export default defineConfig({
             {
               text: '教程',
               items: [
+                { text: '教程概览', link: '/zh-CN/tutorials/' },
                 {
                   text: '基础教程',
                   link: '/zh-CN/tutorials/basic/',
diff --git a/docs/zh-CN/tutorials/index.md b/docs/zh-CN/tutorials/index.md
new file mode 100644
index 0000000..b8765e9
--- /dev/null
+++ b/docs/zh-CN/tutorials/index.md
@@ -0,0 +1,204 @@
+# 教程
+
+欢迎来到 GFramework 教程中心！这里提供从入门到精进的完整学习路径，帮助你掌握这个面向游戏开发的模块化 C# 框架。
+
+## 📚 可用教程
+
+### [基础教程](./basic/)
+
+> 从零开始学习 GFramework，通过构建一个完整的计数器应用，逐步掌握框架的核心概念。
+
+**适合人群**：
+
+- C# 和面向对象编程初学者
+- 希望了解 GFramework 基础架构的开发者
+- 准备使用 Godot + GFramework 进行开发的团队
+
+**学习内容**：
+
+- 开发环境搭建（.NET SDK + Godot）
+- 项目初始化与架构配置
+- Model、Command、System、Utility 核心概念
+- 事件驱动架构实践
+- MVC 模式在游戏开发中的应用
+
+**预计时间**：2-3 小时
+
+---
+
+### [Godot 集成教程](./godot-integration.md)
+
+> 深入学习 GFramework 与 Godot 引擎的深度集成，掌握高级开发技巧。
+
+**适合人群**：
+
+- 已完成基础教程的开发者
+- 需要优化 Godot 项目性能的开发者
+- 希望实现复杂游戏系统的架构师
+
+**学习内容**：
+
+- 节点生命周期管理
+- 信号系统集成与桥接
+- 资源管理优化策略
+- 对象池化系统实现
+- 性能优化最佳实践
+- 调试与测试方法
+
+**预计时间**：3-4 小时
+
+---
+
+### [高级模式教程](./advanced-patterns.md)
+
+> 探索 GFramework 的高级特性和企业级设计模式。
+
+**适合人群**：
+
+- 有 GFramework 实战经验的开发者
+- 需要构建大型复杂游戏系统的团队
+- 对架构设计有深入追求的开发者
+
+**学习内容**：
+
+- CQRS（命令查询职责分离）模式
+- 领域驱动设计（DDD）
+- 事件溯源与事件总线
+- 插件系统架构
+- 多人游戏网络集成
+
+**预计时间**：4-6 小时
+
+---
+
+## 🎯 学习路径建议
+
+### 路径一：快速上手（推荐新手）
+
+```
+基础教程（全章节） → Godot 集成教程（选择性阅读） → 开始你的项目
+```
+
+**时间**：2-3 天
+**目标**：掌握 GFramework 核心，能够独立开发简单游戏
+
+---
+
+### 路径二：系统学习（推荐完整掌握）
+
+```
+基础教程 → Godot 集成教程 → 小项目实践 → 高级模式教程
+```
+
+**时间**：1-2 周
+**目标**：深入理解框架设计思想，能够优化和扩展框架
+
+---
+
+### 路径三：架构师之路（推荐团队负责人）
+
+```
+高级模式教程（预览） → 基础教程 → Godot 集成教程 → 高级模式教程（深入） → 架构设计实践
+```
+
+**时间**：2-4 周
+**目标**：能够设计可扩展、可维护的大型游戏架构
+
+---
+
+## 💡 学习建议
+
+### 实践为王
+
+- **跟随编码**：不要只看，要动手跟着教程敲代码
+- **修改实验**：在示例代码基础上进行修改，观察变化
+- **独立实现**：学完后尝试用学到的东西实现一个小功能
+
+### 理解原理
+
+- **思考设计意图**：每个架构决策背后都有原因
+- **对比传统方式**：理解为什么使用框架会带来好处
+- **举一反三**：将模式应用到其他类似场景
+
+### 善用资源
+
+- **查阅文档**：结合 [Core 核心框架](../core/) 和 [Godot 集成](../godot/) 文档
+- **查看示例**：参考框架附带的示例项目
+- **社区交流**：遇到问题时查看 GitHub Issues 或参与讨论
+
+---
+
+## 📖 前置知识要求
+
+### 必需
+
+- **C# 基础语法**：类、接口、泛型、Lambda 表达式
+- **面向对象编程**：封装、继承、多态
+- **命令行基础**：能够使用终端/命令提示符
+
+### 推荐
+
+- **Godot 引擎基础**：了解节点系统和场景概念
+- **MVC/MVVM 架构**：了解分层架构的基本思想
+- **依赖注入**：了解 IoC 容器的基本概念
+
+---
+
+## 🔗 相关资源
+
+- [入门指南](../getting-started/) - 快速了解框架和安装配置
+- [Core 核心框架](../core/) - 深入学习核心概念
+- [Game 模块](../game/) - 游戏特定功能文档
+- [Godot 集成](../godot/) - Godot 特定功能参考
+- [源码生成器](../source-generators/) - 自动化代码生成工具
+
+---
+
+## ❓ 常见问题
+
+**Q: 我没有 Godot 经验，能学习 GFramework 吗？**
+
+A: 建议先花 1-2 小时了解 Godot 基础概念（节点、场景、信号），这样可以更好地理解教程内容。
+
+**Q: 教程中的代码可以直接用于生产环境吗？**
+
+A: 教程代码主要用于教学目的，生产环境建议参考 [最佳实践](./basic/07-summary.md#最佳实践总结) 章节进行优化。
+
+**Q: 学习过程中遇到问题怎么办？**
+
+A: 可以：
+
+1. 仔细查看错误信息和文档
+2. 对照教程中的完整代码检查自己的实现
+3. 查看 [GitHub Issues](https://github.com/GeWuYou/GFramework/issues)
+4. 提交新的 Issue 寻求帮助
+
+**Q: 完成所有教程需要多长时间？**
+
+A: 根据学习深度不同：
+
+- 快速浏览（了解概念）：4-6 小时
+- 完整实践（动手编码）：10-15 小时
+- 深入理解（举一反三）：20+ 小时
+
+---
+
+## 🚀 准备好了吗？
+
+选择适合你的学习路径，开始 GFramework 之旅吧！
+
+<div style="text-align: center; margin: 2rem 0;">
+
+[开始基础教程 →](./basic/)
+
+</div>
+
+---
+
+::: tip 提示
+本教程文档使用 VitePress 构建，支持全文搜索。使用快捷键 `Ctrl+K`（Windows/Linux）或 `Cmd+K`（macOS）可以快速查找内容。
+:::
+
+::: warning 版本说明
+教程基于 GFramework v1.0+ 编写。如果你使用的是更早的版本，某些 API 可能会有差异。
+:::