每日一仓

ONE OPEN-SOURCE REPO A DAY

每天 08:00 更新 数据来源 · Atlas 精选榜 2026 年 11 月 18 日

第 4 期 · 2026-11-04

freeCodeCamp/freeCodeCamp — 全球最大的免费编程学习平台本身就是开源的

第 4 期看点:全球最大的免费编程学习平台本身就是开源的——它的课程不是写在网页后台里的,而是 1.7 万个 Markdown 文件,靠一套构建流水线编译成可交互的课堂。

一句话定位

freeCodeCamp/freeCodeCamp 是 freeCodeCamp.org 的完整代码库加课程库:一个教数学、编程和计算机科学的免费自学平台,课程、考试、用户进度、捐赠全部跑在这套代码上。它由捐赠支持的非营利组织运营,README 里写明社区已帮助超过 10 万人拿到第一份开发者工作。读它最大的价值不在“又一个全栈项目”,而在它回答了一个很少有人认真回答的问题:一套要服务几百万学习者、持续更新十年的课程,到底应该怎么组织、怎么校验、怎么翻译。

源码结构

克隆下来实测(git clone --depth 1,约 160MB),仓库共 19,801 个文件,其中 Markdown 占 17,037 个——这首先是一个内容仓库,其次才是一个代码仓库:

  • curriculum/(95MB,全仓最大):课程本体。英文挑战目录 curriculum/challenges/english/blocks/ 下有 1,109 个 block 目录、约 1.7 万个挑战文件;certifications/ 下 31 份认证定义(YAML);structure/superblocks/ 下 101 份 superblock 定义(JSON);src/ 下是把 Markdown 编译成课程数据的构建代码(build-curriculum.ts、build-superblock.ts、build-certification.ts)。
  • client/(23MB):学习端前端,Gatsby 5 + React 18 + Redux 4。client/src/templates/Challenges 是做题页模板,client/src/redux/ 里有保存进度、拉取用户、处理捐赠等 saga,如 save-challenge-saga.js、fetch-user-saga.js。
  • api/:后端,Fastify 5 + Prisma 6。api/src/routes/ 分 public 与 protected 两组路由,api/src/plugins/ 里有 auth、cookie、CSRF、邮件等插件;Prisma 模型包括 user、Donation、Exam、Survey、DailyCodingChallenges 等,不只有“做题记录”一张表。
  • packages/:共享包,包括 challenge-builder(挑战构建)、shared(课程配置等公共代码)、challenge-linter 与 eslint 配置。
  • tools/:课程作者工具,包括 challenge-parser(解析挑战 Markdown)、challenge-helper-scripts(新建项目、重命名挑战文件等)、challenge-editor、daily-challenges。
  • 根目录:pnpm workspace + Turborepo 的单仓配置,package.json 要求 Node ≥ 24、pnpm ≥ 12;docker/ 提供本地开发用的 compose 文件。

代码量实测:client、api、packages、tools 四个目录的 TypeScript/TSX 文件合计约 11.7 万行——不算小,但和 1.7 万个挑战文件相比,代码只是少数。课程内容与平台代码的比例,本身就是这个项目的第一条设计信息。

架构图

flowchart TD
    A[课程作者写 Markdown 挑战] --> B[challenge-parser 解析]
    B --> C[curriculum 构建流水线]
    C --> D[课程数据]
    D --> E[client 学习端]
    E --> F[做题页与编辑器]
    F --> G[浏览器内断言判题]
    E --> H[api 后端]
    H --> I[用户进度与认证]
    J[翻译字典与 i18n 流水线] --> C
    K[挑战编辑器与校验脚本] --> A
    L[捐赠与考试模块] --> H

分层设计说明

按实际代码可以分成五层,每层只负责一件事:

  • 内容层(Markdown 挑战):一个挑战就是一个 Markdown 文件。文件头是 frontmatter(id、标题、challengeType、dashedName),正文按 --description--、--instructions--、--hints--、--seed--、--solutions-- 分段。实测的经典例子 basic-javascript 下的“Create Decimal Numbers with JavaScript”:--seed-- 给出初始代码,--hints-- 里是 assert(typeof myDecimal === 'number') 这样的断言,--solutions-- 给出参考答案。内容作者不需要写前端代码,只需要按这个格式填空。
  • 编译层(curriculum 构建):curriculum/src/build-curriculum.ts 读入 block 与 superblock 的结构定义,调用 build-superblock.ts、build-certification.ts,把 1,109 个 block、31 份认证拼成最终课程数据,并做校验。这一层是内容与运行时的分界线:线上跑的不是 Markdown 文件本身,而是编译后的课程数据。
  • 学习端(client):Gatsby 静态站 + React + Redux。做题页模板渲染题目、编辑器与测试结果;Redux saga 负责保存进度、同步用户状态。它的职责是“呈现与交互”,判题逻辑不在这里硬编码,而是执行挑战文件里自带的断言。
  • 服务层(api):Fastify 后端,路由分公开与需登录两组,插件层处理认证、Cookie、CSRF、邮件。Prisma 模型覆盖用户、捐赠、考试、问卷、每日一题,说明后端不只是“存进度”,还承载了认证考试与运营功能。
  • 作者与翻译层(tools + i18n):challenge-parser 解析与校验挑战格式,challenge-editor 是可视化编辑器,challenge-helper-scripts 处理新建、重命名等重复劳动;curriculum/i18n-curriculum/locales/ 下有 arabic、chinese、chinese-traditional、english、espanol、german、italian、japanese、korean、portuguese、swahili、ukrainian 共 12 种语言配置,翻译走字典与专用解析器,而不是直接改英文原文。

技术亮点

亮点一:把“题目”做成带断言的数据,而不是写死在代码里的页面。 每个挑战的 --hints-- 本质上是一组可执行的测试用例,学习者在编辑器里改代码,浏览器直接跑这些断言给反馈。这带来两个实测可验证的好处:一是出题与判题解耦,改题目不需要改前端;二是同一套格式能覆盖多种题型——实测 challengeType 分布里,数量最多的几类分别是 0 号(4,654 个)、19 号(4,119 个)、22 号(2,933 个)、1 号(1,659 个)、20 号(1,258 个),说明格式本身被反复复用,而不是每种题单独写一套页面。代价也很明确:断言写得不严谨,学习者就可能用取巧代码通过测试;所以仓库才需要 challenge-linter、challenge-auditor 这类配套工具,把“题目质量”也纳入工程流程,而不是只靠人工审稿。

亮点二:课程组织是三级结构,认证不是“学完即发证”。 结构上是 superblock(大方向,如 Responsive Web Design、Python)→ block(主题单元,1,109 个)→ challenge(单节课,约 1.7 万个),认证定义则单独放在 certifications/ 的 YAML 里。README 写明的全栈路径是 6 门认证:响应式网页设计、JavaScript、前端库、Python、关系数据库、后端与 API;每门认证要求完成互动课程加 5 个必做项目,通过考试后才能领证。也就是说,证书的含金量不来自“刷完课”,而来自“项目 + 考试”两道门。这个设计的边界同样清楚:它适合自律的自学者和转行者,但不提供老师批改、结对编程或就业安置——平台把“学”做到了免费和规模化,把“辅导”留给了论坛与社区。

亮点三:单仓 + 构建流水线让 1.7 万篇内容可维护。 课程、前端、后端、工具全放在一个 pnpm + Turborepo 单仓里,turbo build、turbo develop、turbo lint 统一调度;内容变更走 Markdown PR,格式、链接、结构由解析器与构建脚本在合并前校验,翻译走字典而不是各语言各改一份原文。实测的另一面是门槛:Node ≥ 24、pnpm ≥ 12,完整克隆 160MB、课程构建本身就是一项重活,本地跑全套开发环境需要按文档配数据库与环境变量,并不适合“只想看一节课”的人随手启动。这也是它值得参考而非照搬的地方:规模越大,越需要构建层;规模没到这个量级,先抄它的挑战文件格式,比先抄它的单仓配置更划算。

值得参考的设计或实现

  • 挑战文件格式可直接借鉴:frontmatter + --seed--/--hints--/--solutions-- 分段 + 断言判题,是一套不依赖任何框架的“互动题目”规范。做内部培训、校内 OJ、新手引导时,照这个格式写 Markdown,就能把内容、测试、答案三件事分开维护。
  • 三级课程结构:superblock、block、challenge 的分层,加上认证定义与课程内容分离,让“调整学习路径”不需要动题目本身。排课、做知识库、做 onboarding 路径时,这个分层比扁平的文章列表好维护得多。
  • 内容即数据、构建即校验:Markdown 不是直接上线的页面,而是先经过解析、结构拼装、校验再编译成运行数据。内容团队可以只写 Markdown,工程团队守住构建入口,出了问题先查构建日志而不是逐页翻网页。
  • 翻译与原文分离:12 种语言的翻译走字典与专用解析器,原文改动不会直接污染译文,译文缺失也能被发现。这对任何要做多语言内容的产品都适用:先定字典与同步流程,再谈翻译质量。
  • 证书与考试挂钩:互动课 + 5 个项目 + 考试的三段式,比“看完视频即发证”更能让证书被外部认可,也让防刷题有了抓手——项目与考试是两道人工或系统可复核的关口。

适合谁

  • 零基础或转行自学者:按 6 门全栈认证的顺序走,不用自己拼课程表;每节课都有可运行的断言反馈,不需要先配环境。
  • 想系统补前端、Python、数据库、后端任意一段的人:1,109 个 block 是按主题切分的,可以只挑一段,不必从头学起。
  • 做培训、技术布道、企业内训的人:课程结构、题目格式、认证模型都可以直接参考,BSD-3-Clause 许可证也允许在合规前提下复用。
  • 想给开源做贡献的开发者:内容贡献(写题、改题、翻译)与代码贡献(前端、后端、工具)是两条并行的路,不会写 React 也能从改一道题开始。

怎么上手

  • 当学习者:直接打开 freeCodeCamp.org/learn,按认证路径做题,不需要安装任何东西;做题页内置编辑器与测试,本地零配置。
  • 当读者读源码:先看 curriculum/challenges/english/blocks/ 里任意一个 block 的 Markdown,理解题目格式;再看 curriculum/structure/superblocks/ 与 certifications/,理解路径与认证是怎么拼出来的;最后看 curriculum/src/build-curriculum.ts,理解 Markdown 如何变成课程数据。
  • 当贡献者本地跑起来:克隆仓库后按 README 的开发文档安装 pnpm、配好环境变量与数据库,用 pnpm develop 起 client 与 api;改题目用 tools/challenge-editor,改完跑对应的 lint 与测试再提 PR。注意完整环境较重,第一次启动建议留足时间,只改内容的话不一定需要跑起全套服务。

数据卡

  • 仓库:freeCodeCamp/freeCodeCamp
  • Star:458,504(Atlas 快照 458,207)
  • Fork:48,152
  • 主要语言:TypeScript
  • 许可证:BSD-3-Clause
  • Atlas 分类:学习资源与 Awesome;领域:教育与研究
  • 创建时间:2014-12-24
  • 最近更新:2026-11-03(GitHub 实时数据,查询于 2026-11-04)
  • 实测体量:19,801 个文件,约 160MB;挑战约 1.7 万个,block 1,109 个,认证定义 31 份,superblock 定义 101 份,翻译语言 12 种;client、api、packages、tools 的 TypeScript/TSX 约 11.7 万行
  • 未解决 Issue:176 个;关注者:8,584 人

← 返回仓库目录