这份清单按语言和学习阶段筛选 6 个可动手项目,并统一补充产出、测试和完成标准。链接用于前往原教程,本站不复制其正文;完成一个小项目比同时收藏几十个教程更有价值。
先选一个项目,再定义完成标准
根据当前语言选择一个 1–2 周能完成最小版本的项目。先写一句用户价值,再列三项核心功能和明确的非目标,避免教程之外无限扩张。
每个项目都使用同一套交付要求:
- README 写明运行环境、启动命令、截图和已知限制。
- 将大步骤拆成小提交,每次提交保持可运行。
- 至少测试空输入、非法输入、重复操作和外部服务失败。
- 配置示例不包含真实密钥,个人信息和数据库文件不进入公开仓库。
- 最后写一篇复盘:遇到的错误、关键取舍和下一步最小改进。
完整清单见project-based-learning 固定版本。以下外部链接均来自该清单;教程可能较旧,开始前要核对当前语言与依赖的官方文档。
Python:Web 应用与完整业务流程
项目 1:Flask 微博客
原始教程:The Flask Mega-Tutorial。
适合已经掌握 Python 函数、类和基本 HTML 的学习者。最小版本只完成应用结构、模板、表单和数据库模型,再逐步加入用户与文章。
- 核心产出:注册、登录、发布和分页查询四条流程。
- 补做测试:重复用户名、未登录访问、空正文和数据库不可用。
- 安全提醒:密码哈希、会话配置和权限检查必须按当前框架文档实现,不照搬过期片段。
项目 2:Django 博客
原始教程:Django Girls Tutorial。
适合第一次接触完整 MVC/MTV 结构的学习者。重点理解 URL、视图、模板和模型如何协作,而不是只复制命令。
- 核心产出:文章列表、详情、创建和编辑,附数据库迁移。
- 补做测试:草稿不公开、作者权限、无效 slug 和重复提交。
- 过关标准:能独立新增一个字段,并完成模型、迁移、表单、模板和测试的同步修改。
JavaScript:浏览器交互与原生能力
项目 3:JavaScript30 小练习精选
原始教程:JavaScript30。
不要机械完成 30 天数量目标。选择时钟、数组练习、图片滑动画廊和本地存储四类,分别对应时间、数据处理、CSS 交互与持久化。
- 核心产出:4 个独立页面和一页通用问题总结。
- 补做测试:快速连续操作、后台标签页、空本地数据和刷新恢复。
- 过关标准:能解释事件流、定时器、DOM 状态和浏览器存储各自边界。
项目 4:原生 JavaScript Todo List
原始教程:dwyl JavaScript Todo List Tutorial。
适合练习测试驱动和状态更新。先把新增、完成、删除写成可测试的纯函数,再接入 DOM,避免所有逻辑都塞进点击回调。
- 核心产出:任务状态模型、交互页面和自动化测试。
- 补做测试:空标题、重复任务、全部完成、删除中间项和本地数据损坏。
- 扩展限制:第一版不接后端、不加账号,先证明状态逻辑正确。
Java:服务端安全与协议基础
项目 5:Spring Boot 用户认证应用
原始教程:Spring Securing Web。
适合有 Java 和基础 Web 知识的学习者。重点理解登录页、认证、授权和模板保护,不将前端隐藏按钮当成权限控制。
- 核心产出:公开页、登录页、受保护页和退出流程。
- 补做测试:错误密码、未登录跳转、已登录访问和退出后回退。
- 过关标准:能区分认证与授权,并说明密码、会话和 CSRF 防护由谁负责。
Go:HTTP 服务与可测试接口
项目 6:Gin Web 服务
原始教程:Building Go Web Applications and Microservices Using Gin。
适合已掌握 Go 基础语法和包管理的学习者。先实现少量资源与内存存储,再引入数据库;不要第一天就拆多个微服务。
- 核心产出:健康检查、资源列表、创建和详情接口。
- 补做测试:非法 JSON、重复 ID、不存在资源、请求体过大和服务错误。
- 工程要求:使用
go test覆盖 handler,配置通过环境变量注入,服务支持超时与优雅退出。
项目完成后的统一验收
发布作品前,请一位未看过教程的人按 README 启动。如果对方必须猜测环境、目录或账号,就说明交付仍不完整。
- 核心流程可在干净环境运行,不依赖作者电脑上的隐藏文件。
- 依赖版本和启动命令明确,外部服务失败有可读错误。
- 测试覆盖关键规则,不只是打开首页没有报错。
- 页面或接口对空状态和重复操作行为一致。
- 教程来源、第三方素材和许可证有记录,自己的修改可辨认。
来源、版本与许可
- 上游项目:practical-tutorials/project-based-learning。
- 固定 Commit:
f99ea242247b9b6df9bd277f832fa5a8f1da28e1。 - 上游版权:Copyright (c) 2021 practical-tutorials。
- 上游许可:MIT License。
本文从上游固定版本中精选 6 个链接,并重新编写学习顺序、产出、测试和验收清单。清单的 MIT 许可不覆盖被链接教程、代码和素材;再利用这些内容前,分别查看原始站点与仓库的许可和版本说明。