# 小蓝书 Go 教学文档

本套文档面向第一次接触编程、Go 和 Web 项目的读者。目标是能运行、能操作、能沿请求读懂代码，再能独立修改一项功能。无需先学 Java，也无需先安装十几个中间件。

编写方式参考 `D:\codex小项目\go\web3\docs`：主题分区、连续初学路线、前后章节导航、真实代码入口、动手验收、单独保存验证报告。这里讨论的是小蓝书社区业务；不会把交易系统的术语和成绩搬过来。

## 按这个顺序学习

| 顺序 | 章节 | 学完能做什么 |
| --- | --- | --- |
| 1 | [01 项目导览](01-beginner/01-project-tour.md) | 说出产品功能与一次动作的参与者 |
| 2 | [02 电脑、终端与文件](01-beginner/02-tools.md) | 进入正确目录、识别命令与输出 |
| 3 | [03 Web 与数据库基础](01-beginner/03-web-basics.md) | 分清 HTTP、JSON、前后端和数据库 |
| 4 | [04 第一次运行](01-beginner/04-first-run.md) | 从下载依赖到打开页面 |
| 5 | [05 双账号体验](01-beginner/05-business-walkthrough.md) | 完成发布、评论、关注和管理 |
| 6 | [06 Go 入门](01-beginner/06-go-basics.md) | 读懂函数、结构体、指针和 error |
| 7 | [07 沿请求读代码](01-beginner/07-read-code.md) | 从按钮找到 HTTP、规则与 SQL |
| 8 | [08 SQL 和事务](01-beginner/08-sql-transactions.md) | 理解表、键、约束、事务和幂等 |
| 9 | [09 第一次亲手修改](01-beginner/09-first-change.md) | 一次完成前后端、测试和文档改动 |
| 10 | [10 学习检查表](01-beginner/10-checklist.md) | 判断自己哪里懂、哪里还需练习 |

建议第一轮每天一至两章。遇到术语先查[词汇表](00-overview/glossary.md)，不要同时打开所有源文件。前四章以看见结果为目标，第六章以后才开始解释实现。

## 第二轮：理解架构和完整源码

| 主题 | 文档 |
| --- | --- |
| 模块、启动与请求流 | [架构总览](02-architecture/architecture.md) |
| 每张表、字段和不变量 | [数据模型](02-architecture/data-model.md) |
| Java 模块逐项迁移 | [迁移说明](02-architecture/migration.md) |
| 认证、权限与文件边界 | [安全与会话](02-architecture/security.md) |
| 固定版本和升级理由 | [依赖与环境](03-development/dependencies.md) |
| 所有公开 API 与例子 | [接口手册](03-development/api.md) |
| Go 认证源码 | [登录与权限](03-development/auth.md) |
| 笔记、计数和搜索源码 | [笔记与搜索](03-development/notes-search.md) |
| 评论与用户关系源码 | [评论与关系](03-development/comments-relations.md) |
| React、样式和状态 | [前端工程](03-development/frontend.md) |
| 从空文件夹实现核心链路 | [从零编写教程](03-development/from-zero.md) |
| 每个源文件读什么 | [源码索引](03-development/file-index.md) |

## 第三轮：验证、部署与排错

- [自动测试与漏洞检查](04-testing/automated.md)：测试为何存在、怎么读失败结果。
- [手动验收](04-testing/manual.md)：两个普通账号与管理员的完整步骤。
- [常见问题](04-testing/troubleshooting.md)：症状 → 检查 → 修复 → 验证。
- [配置和本地部署](05-deployment/local.md)：环境变量、路径、热更新和端口。
- [生产、Docker 和备份](05-deployment/production.md)：单实例部署与恢复验证。
- [面试和进阶题](06-interview/questions.md)：先理解因果，再练习表达。
- [实际验证报告](reports/2026-11-14-refactor.md)：本次检查的真实结果和限制。
- [视觉方案](00-overview/design-plan.md)：设计 skill 如何转成具体页面选择。

## 阅读约定

除非明确说明，命令都在 `D:\xiaolanshu-go` 运行。PowerShell 代码块内只复制命令，不复制提示符。`<你的值>` 是需要替换的说明，不是字面参数。运行结果以本地实际输出为准；本教程不会要求你改全局 Go 代理、清空别人的数据库或为了跟示例一致而重置已有资料。

源码路径相对项目根目录，文档内链接可点击。代码片段用于解释，完整实现以源码为准。标为“进阶”的方案是后续扩展方向，不是当前已实现功能。先完成每章末尾验收，再进入下一章。
