Project Based Learning 项目式学习

Project Based Learning：安装说明

这个工具包里只有安装说明，由 Mindket 编写。清单本身就是 practical-tutorials 仓库的 README，地址是 https://github.com/practical-tutorials/project-based-learning

这些说明不是 practical-tutorials 的维护者写的，也没有得到他们的认可。这个仓库在 GitHub 上的描述是“Curated list of project-based tutorials”，意思是：一份精选的项目式教程清单。README 说它是“A list of programming tutorials in which aspiring software developers learn how to build an application from scratch.”，意思是：一份编程教程清单，有志于做开发的人在里面学会从零做出一个应用。来源见 https://github.com/practical-tutorials/project-based-learning/blob/master/README.md

许可证：MIT。GitHub 的仓库信息写的是“MIT License”，许可证文件 LICENSE.md（https://github.com/practical-tutorials/project-based-learning/blob/master/LICENSE.md）写的是“Copyright (c) 2021 practical-tutorials”。许可证覆盖的是仓库自己的文件：README 清单、CONTRIBUTING.md、检查脚本和工作流。清单链接到的每个教程都有自己的作者和条款。

它是什么

是一份清单，不是程序。README 里有：

• 一小段介绍和一个目录，每门语言一个链接
• 每门主要编程语言一个栏目，比如 C/C++、Go、Python、Rust 和 Swift，较大的栏目里还有子栏目（例如 C/C++ 下面的 Network programming，Python 下面的 Web Scraping、Bots 和 Data Science）
• 每个栏目下面，每个教程一行：- [Title](link)。一个系列是一行标题，下面嵌套着它的各个部分，常见的是 - [Part 1](link) 这样的行
• 最后一个 Additional Resources 栏目，列的是整个网站，而不是单个教程

README 写道“Tutorials may involve multiple technologies and languages.”，意思是：教程可能涉及多种技术和语言。有些条目标明是视频。维护者把一个 Haskell 条目标为过时。

仓库里还有 CONTRIBUTING.md、一个放着维护者对 README 运行的 Python 检查脚本的 scripts/ 文件夹，以及 .github/workflows/ 里的三个工作流文件。来源见仓库的文件树（https://github.com/practical-tutorials/project-based-learning）和 README。

会安装什么

阅读清单的话，什么都不装。README 没有给出安装命令。可选的检查只用 Python 3，别的都不需要：脚本自己的开头写着“Python 3 stdlib only”，意思是：只用 Python 3 标准库。来源见 https://github.com/practical-tutorials/project-based-learning/blob/master/scripts/check_readme.py

需要先准备什么

• 阅读清单：一个浏览器，或者任何能打开 Markdown 文件的程序。
• 想 fork：一个 GitHub 账号。README 写道“To get started, simply fork this repo.”，意思是：想上手，直接 fork 这个仓库。fork 是 GitHub 的功能（Mindket 的说明，不是 README 里的一行）。
• 想保留本地副本：Git。README 没有给出克隆命令。GitHub 的仓库信息报告的克隆地址是 https://github.com/practical-tutorials/project-based-learning.git，对它运行 git clone 是普通的 Git 用法（Mindket 的说明）。
• 想运行维护者的 lint：Python 3，因为 CONTRIBUTING.md 运行的是 python3。
• 做某个教程：它自己写明的东西。每个教程都在自己的网站上，会说明它需要什么。

各平台的说明

• setup/read-and-search.md：在 GitHub 上读 README、fork、本地副本，以及怎样在里面找到一个教程
• setup/ai-agents.md：把这份清单交给 Claude Code、Codex、Cursor 和其他智能体（Mindket 的说明，因为维护者没有写任何智能体的步骤）
• setup/contribute-and-check.md：条目格式、拉取请求的规则、lint 和链接检查

更新或删除

本地副本就是一个 Git 文件夹。要更新，在里面运行 git pull（Mindket 的说明，普通的 Git 用法）。要删除，删掉这个文件夹。fork 在 GitHub 上、在这个 fork 的设置里删除（Mindket 的说明，GitHub 的功能，不是 README 里的一行）。README 没有给出卸载步骤，也没有安装别的东西。

对外连接

• 在 GitHub 上阅读 README 会加载 GitHub。清单里的每个链接会加载教程自己的网站：博客、GitHub 仓库、YouTube 视频和课程页面。这些网站不是 Mindket 的，也不是维护者的。
• python3 scripts/check_readme.py lint 读取 README.md，不发出任何网络请求。check-links 会给它检查的每个链接发一个网络请求。来源见 https://github.com/practical-tutorials/project-based-learning/blob/master/scripts/check_readme.py
• 维护者的工作流每周在 GitHub 的服务器上运行一次链接检查。见 setup/contribute-and-check.md。

来源

• README：https://github.com/practical-tutorials/project-based-learning/blob/master/README.md
• LICENSE.md：https://github.com/practical-tutorials/project-based-learning/blob/master/LICENSE.md
• CONTRIBUTING.md：https://github.com/practical-tutorials/project-based-learning/blob/master/CONTRIBUTING.md
• 拉取请求模板：https://github.com/practical-tutorials/project-based-learning/blob/master/.github/PULL_REQUEST_TEMPLATE.md
• 检查脚本：https://github.com/practical-tutorials/project-based-learning/blob/master/scripts/check_readme.py
• 工作流：https://github.com/practical-tutorials/project-based-learning/tree/master/.github/workflows
• GitHub 的仓库信息：https://api.github.com/repos/practical-tutorials/project-based-learning