本套文档面向第一次接触编程、Go 和 Web 项目的读者。目标是能运行、能操作、能沿请求读懂代码,再能独立修改一项功能。无需先学 Java,也无需先安装十几个中间件。
编写方式参考 D:\codex小项目\go\web3\docs:主题分区、连续初学路线、前后章节导航、真实代码入口、动手验收、单独保存验证报告。这里讨论的是小蓝书社区业务;不会把交易系统的术语和成绩搬过来。
按这个顺序学习#
| 顺序 | 章节 | 学完能做什么 |
|---|---|---|
| 1 | 01 项目导览 | 说出产品功能与一次动作的参与者 |
| 2 | 02 电脑、终端与文件 | 进入正确目录、识别命令与输出 |
| 3 | 03 Web 与数据库基础 | 分清 HTTP、JSON、前后端和数据库 |
| 4 | 04 第一次运行 | 从下载依赖到打开页面 |
| 5 | 05 双账号体验 | 完成发布、评论、关注和管理 |
| 6 | 06 Go 入门 | 读懂函数、结构体、指针和 error |
| 7 | 07 沿请求读代码 | 从按钮找到 HTTP、规则与 SQL |
| 8 | 08 SQL 和事务 | 理解表、键、约束、事务和幂等 |
| 9 | 09 第一次亲手修改 | 一次完成前后端、测试和文档改动 |
| 10 | 10 学习检查表 | 判断自己哪里懂、哪里还需练习 |
建议第一轮每天一至两章。遇到术语先查词汇表,不要同时打开所有源文件。前四章以看见结果为目标,第六章以后才开始解释实现。
第二轮:理解架构和完整源码#
| 主题 | 文档 |
|---|---|
| 模块、启动与请求流 | 架构总览 |
| 每张表、字段和不变量 | 数据模型 |
| Java 模块逐项迁移 | 迁移说明 |
| 认证、权限与文件边界 | 安全与会话 |
| 固定版本和升级理由 | 依赖与环境 |
| 所有公开 API 与例子 | 接口手册 |
| Go 认证源码 | 登录与权限 |
| 笔记、计数和搜索源码 | 笔记与搜索 |
| 评论与用户关系源码 | 评论与关系 |
| React、样式和状态 | 前端工程 |
| 从空文件夹实现核心链路 | 从零编写教程 |
| 每个源文件读什么 | 源码索引 |
第三轮:验证、部署与排错#
- 自动测试与漏洞检查:测试为何存在、怎么读失败结果。
- 手动验收:两个普通账号与管理员的完整步骤。
- 常见问题:症状 → 检查 → 修复 → 验证。
- 配置和本地部署:环境变量、路径、热更新和端口。
- 生产、Docker 和备份:单实例部署与恢复验证。
- 面试和进阶题:先理解因果,再练习表达。
- 实际验证报告:本次检查的真实结果和限制。
- 视觉方案:设计 skill 如何转成具体页面选择。
阅读约定#
除非明确说明,命令都在 D:\xiaolanshu-go 运行。PowerShell 代码块内只复制命令,不复制提示符。<你的值> 是需要替换的说明,不是字面参数。运行结果以本地实际输出为准;本教程不会要求你改全局 Go 代理、清空别人的数据库或为了跟示例一致而重置已有资料。
源码路径相对项目根目录,文档内链接可点击。代码片段用于解释,完整实现以源码为准。标为“进阶”的方案是后续扩展方向,不是当前已实现功能。先完成每章末尾验收,再进入下一章。