freeCodeCamp

由 freeCodeCamp 制作工具包教育

新上架第 2 版 · 更新于 2026-11-09

星标459k

freeCodeCamp.org 的开源代码和课程。freeCodeCamp.org 是一个可以免费学编程的社区，由一家靠捐款运转的 501(c)(3) 慈善组织运营。这里的说明涵盖在网站上学习，在 macOS、Linux、WSL2、Dev Container 或 Codespaces 上运行平台，以及提交修改。

freeCodeCamp 是一款 GitHub 上的开源项目，属于教育类，由 Mindket 上架。可免费获取。当前为第 2 版，最近更新于 2026-11-09。按它的 README 从 GitHub 安装。Mindket 的设置说明可在你的 Mindket 账户获取，以 zip 压缩包下载。

速览

用在

freeCodeCamp.org：线上的网站，在浏览器里用，什么都不用安装
macOS 和 Linux：作者的 Local Machine 安装方式，需要 Git、Node.js、pnpm 和 Docker Compose
Windows：安装页说这个项目只支持 macOS 和 Linux，并要求先设置 WSL2。GitHub Codespaces 不需要在你的机器上安装任何东西
Dev Container：在你自己的机器上，用 VS Code、Docker Desktop 和 Dev Containers 扩展

先运行

git clone --depth=1 https://github.com/YOUR_USER_NAME/freeCodeCamp.git
cd freeCodeCamp
git remote add upstream https://github.com/freeCodeCamp/freeCodeCamp.git

平台

macOS操作系统

Linux操作系统

Docker容器

Windows操作系统

VS Code代码编辑器

关于

它是什么

freeCodeCamp 是 freeCodeCamp.org 的开源代码和课程，它的 README 说 freeCodeCamp.org“由一家靠捐款运转的 501(c)(3) 慈善组织运营”。README 还称这个站点是“一个可以免费学编程的友好社区”，并说“这段代码正在 freeCodeCamp.org 上运行”。仓库里有这个平台，也有它背后的课程：讲解课、工作坊、实验、复习页和测验。Mindket 的安装说明讲怎么在网站上学习、怎么自己运行这个平台、怎么改课程，以及怎么提交修改。

打开 freeCodeCamp.org/learn，选一个认证
学完讲解课、工作坊、实验、复习页和测验
完成 5 个必做项目
通过考试
领取认证

仓库里有什么

文件夹	里面有什么
`curriculum/`	课程内容，按超级模块、章节、模块、块和挑战分组（旧版超级模块把块平铺列出），另有定下它们顺序的 JSON 文件。这些文件的版权属于 freeCodeCamp.org，说明里没有收入。
`client/`	用户使用的网页应用，作者的文档称它为 client。它里面超级模块和块的文字在 client/i18n/locales/english/intro.json。
`api/`	API 服务器。安装页说它在 3000 端口响应，文档在 /documentation。
`docker/`	启动 MongoDB 和 Mailpit 的 Docker Compose 文件。
`.devcontainer/`	Dev Container 和 GitHub Codespaces 的配置。
`e2e/`	Playwright 端到端测试。
`packages/` 和 `tools/`	共用代码，以及用来灌入数据库、创建新课程和运行挑战编辑器的脚本。

适合谁

想免费学网页开发、Python、数据库或一门职场语言的人，以及想帮忙建设平台或课程的开发者。学习并不需要这个仓库，网站本身就是产品。当你想看课程怎么存放、运行自己的副本或提交一个修复时，仓库才派得上用场。

谁在用，怎么用

行业	谁在用	怎么用	例子
自学	转行进入科技行业的成年人	在网站上跟着一个认证，从第一课学到考试	一位学习者从响应式网页设计开始，做完必做项目，通过考试，领取认证。
语言学习	工作中要用英语、西班牙语或中文的开发者	按模块学完一个语言认证	一位开发者学 A2 English for Developers，里面有热身、讲解、练习、复习页和测验。
面试准备	求职者	用 README 列出的面试材料	一位求职者做 Coding Interview Prep 和 Project Euler，两者都在 README 的列表里。
课程贡献者	改进课程、项目用户故事和自动测试的志愿者	只运行自己改过的那个块，测试它，再提交拉取请求	一位志愿者修一个工作坊步骤，只构建那个块，推送前运行它的测试。
平台贡献者	懂 JavaScript、React 和 Node.js 的开发者	在自己的机器上运行 client 和 API，修一个 bug 或一个界面	一位贡献者修一个对比度问题，按作者的格式写拉取请求标题，例如 fix(a11y): improved search bar contrast。

如果你只想学习，可以不用这个仓库。网站不用安装任何东西，而且作者的安装说明讲的是开发环境，不是生产环境的指南。

用在哪里

学习在 freeCodeCamp.org 上进行。说明里为网站和代码能运行的每一种地方各写了一个文件。作者没有写任何编程智能体的安装方式，它的 FAQ 规定了 AI 工具的用法。

freeCodeCamp.org：线上的网站，在浏览器里用，什么都不用安装
macOS 和 Linux：作者的 Local Machine 安装方式，需要 Git、Node.js、pnpm 和 Docker Compose
Windows：安装页说这个项目只支持 macOS 和 Linux，并要求先设置 WSL2。GitHub Codespaces 不需要在你的机器上安装任何东西
Dev Container：在你自己的机器上，用 VS Code、Docker Desktop 和 Dev Containers 扩展
GitHub Codespaces：GitHub 服务器上一台 4 核、16 GB 的机器，本地什么都不用装
编程智能体：说明里多了一个文件，写了提示语和注意事项，还有作者的 FAQ 对 AI 工具的规定

如何设置

点“获取”会在你的下载文件夹里存一个 Mindket 安装说明的 zip，每一种使用 freeCodeCamp 的方式各有一个文件。在网站上学习不用安装任何东西。运行平台则要先有这个仓库的一个 fork，也就是你在 GitHub 上的自己的那份副本。

先要准备什么

方式	作者列出的要求
在网站上学习	一个浏览器。README 链接了各个认证的 Learn 页面和一个登录页。
本地机器	4 个 CPU 核心、8 GB 内存、10 GB 磁盘，加上 Git、Node.js 24.x、pnpm 12.x 和 Docker Compose 2.x。
Windows	WSL2，页面推荐 Playwright 支持的 Ubuntu LTS 版本。另外还列出满足 WSL 要求的 Windows 版本，6 个或更多核心，12 GB 或更多内存，20 GB 或更多空闲磁盘。
Dev Container	Git、分到 4 个 CPU 和 16 GB 内存的 Docker Desktop、VS Code 和 Dev Containers 扩展。
GitHub Codespaces	GitHub 上的一个 fork。每月有免费额度，超出要付费。

在 GitHub 上 fork 这个仓库。这样你就有了自己的副本。
克隆 fork，加上主仓库。用下面第一段命令，把 YOUR_USER_NAME 换成你的 GitHub 用户名。
空出 27017 端口。停掉已经占用它的 MongoDB 服务器。
安装、灌数据并启动。运行第二段命令。WSL2 用户要在 pnpm install 之前先运行 pnpm run playwright:install-build-tools。
打开 http://localhost:8000。完整的课程构建先要几分钟。

安装页给本地机器的这些步骤编了号。第一段命令克隆你的 fork，再把主仓库加成第二个远程：

git clone --depth=1 https://github.com/YOUR_USER_NAME/freeCodeCamp.git
cd freeCodeCamp
git remote add upstream https://github.com/freeCodeCamp/freeCodeCamp.git

第二段命令创建环境文件、安装依赖、启动 MongoDB 和 Mailpit、灌入一个测试用户，再启动应用：

cp sample.env .env
pnpm install
docker compose -f docker/docker-compose.yml -f docker/docker-compose.ports.yml up -d
pnpm run seed
pnpm run develop

安装页说，完整的课程构建要几分钟。

如何使用

先想清楚要做什么。想学习，就用网站。想改平台或课程，就运行你自己的副本，只构建你动过的部分。

作者列出的命令

命令	作者说它做什么
`pnpm run develop`	启动 API 服务器和 client，完整构建课程，用于全面测试。
`FCC_BLOCK='workshop-curriculum-outline' pnpm run develop`	只构建并运行这个块。FCC_SUPERBLOCK 和 FCC_CHALLENGE_ID 的用法相同。
`pnpm run seed`	创建测试用户并写入 MongoDB，同时写入考试和问卷。
`pnpm run seed:certified-user`	创建一个已完成全部认证的测试用户。它会让你退出登录。
`FCC_BLOCK='workshop-curriculum-outline' pnpm run test-curriculum-content`	测试课程的一个块。先运行一次 pnpm -F=@freecodecamp/curriculum install-puppeteer。
`pnpm test-api`	运行服务器测试套件。pnpm test-client 和 pnpm playwright:run 分别运行 client 测试和端到端测试。
`pnpm run clean`	卸载所有依赖并清理缓存。

提交修改时，每个 issue 开一个新分支，不要在 main 上改。作者要求提交信息和拉取请求标题都用约定式格式：类型、可选的范围和一句简短的描述。类型有 fix、feat、refactor 和 docs。会改变页面行为的拉取请求应该附上 Playwright 集成测试。页面给的标题示例是：

fix(curriculum): tests for the do...while loop challenge

示例

你想看响应式网页设计的第一个课程块是怎么存放的。在 curriculum/structure/superblocks/responsive-web-design-v9.json 里，第一个章节是 html，它的第一个模块是 basic-html，它的第一个块是 workshop-curriculum-outline。这个块在 curriculum/structure/blocks/ 里的文件给它标上 workshop 标签和 challenge-grid 布局，并按顺序列出它的各个步骤。每个步骤是一个 Markdown 文件，用它的 id 命名，放在 curriculum/challenges/english/blocks/workshop-curriculum-outline/ 里。只构建和测试这一个块：

FCC_BLOCK='workshop-curriculum-outline' pnpm run develop
FCC_BLOCK='workshop-curriculum-outline' pnpm run test-curriculum-content

Mindket 在 2026 年 11 月 3 日读了这些文件，没有运行这个平台，所以这里没有构建时间的测量。要只测第一步，作者的页面用它的 id：

FCC_CHALLENGE_ID=6823ac607bfdbc46331b2559 pnpm run test-curriculum-content

新手与专家

新手：先在网站上学，不要一上来就看仓库。学习不需要 Git、Node.js 或 Docker。安装页说你随时可以删掉自己的 fork 重新开始，所以在那里出错代价很小。贡献者文档的 FAQ 把新手指向 Basic Git Workflow 那一页。如果安装觉得麻烦，GitHub Codespaces 不会在你的机器上装任何东西，不过第一次构建要几分钟。

专家：FAQ 写出了技术栈：Node.js、MongoDB、OAuth 2.0、React、Gatsby 和 Webpack。这个仓库是一个用 Turborepo 构建的 pnpm 工作区，Git 工作流那一页说团队用 Turborepo 做缓存和并行任务。MongoDB 以副本集运行，compose 文件会替你启动并初始化它。

课程构建会读 JSON 结构文件，用 FCC_ 开头的环境变量可以单独构建一个块、一个超级模块或一个挑战。翻译后的挑战放在 i18n-curriculum 子模块里，文件结构那一页说它会自动更新。FAQ 说目前不接受翻译课程的贡献。开发时，sample.env 打开了开发登录模式，排错页说这个登录路由不需要密码。

注意事项

这些说明是 Mindket 自己写的，依据 2026 年 11 月 3 日读到的仓库和作者的文档。它们不是 freeCodeCamp.org 写的，也没有得到它的认可，里面没有它的任何课程内容。

许可证：README 说软件用 BSD-3-Clause，/curriculum 里的文件版权归 freeCodeCamp.org 所有（© 2014）。说明里没有引用课程文字或挑战文件。要复用某一课之前，请先读 License 一节
只用于开发：这些安装页讲的是开发环境。Mindket 没有读到它的生产环境指南，也没有运行这个平台
版本：安装页说，Node.js 或 pnpm 的版本和列出的不一致，是安装失败最常见的原因
公开端口：在 codespace 里，3000 端口必须保持公开，任何有网址的人都能访问它。用完请停掉 codespace
强制推送：Git 工作流那一页在同步步骤里，让你在自己的 fork 上先运行 git reset --hard upstream/main，再运行 git push origin main --force。它还警告说，你会丢掉从 fork 的 main 上发起的拉取请求
AI 工具：FAQ 允许在代码里用，但说团队不会回应由 AI 写成的 issue、拉取请求或讨论里的回复。它可能会关闭低投入的拉取请求
对外连接：安装会下载软件包和容器镜像，sample.env 里论坛、新闻和电台的地址指向 freecodecamp.org。文档没有列出运行中的副本会连接哪些地方
移除：删掉你的克隆，再用 Docker 自己的工具停止并删除 Docker 容器和 db-data 卷

README 和文件

README

freeCodeCamp：安装说明

这个工具包里只有安装说明，由 Mindket 编写。代码和课程都是 freeCodeCamp/freeCodeCamp 仓库里的文件，地址是 https://github.com/freeCodeCamp/freeCodeCamp

这些说明不是 freeCodeCamp.org 写的，也没有得到它的认可。GitHub 对这个仓库的描述是“freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.”，意思是：freeCodeCamp.org 的开源代码和课程，免费学数学、编程和计算机科学。README 的第一个标题是“freeCodeCamp.org's open-source codebase and curriculum”。来源：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/README.md

许可证：分成两部分，按 README 的 License 一节所说。“The computer software is licensed under the BSD-3-Clause license.”，意思是：计算机软件按 BSD-3-Clause 许可证授权。GitHub 对这个仓库的回答把它标为 BSD 3-Clause "New" or "Revised" License（BSD-3-Clause），package.json 里写的也一样。“The learning resources in the /curriculum directory including their subdirectories therein are copyright © 2014 freeCodeCamp.org”，意思是：/curriculum 目录及其子目录里的学习资源，版权归 freeCodeCamp.org 所有（© 2014）。所以 curriculum/ 里的讲解课、工作坊、实验、复习页和测验不在 BSD 许可证之下。这个工具包里没有它们，只说明它们在哪里、怎么构建和测试，别的都没有。来源：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/README.md、https://github.com/freeCodeCamp/freeCodeCamp/blob/main/LICENSE.md 和 https://api.github.com/repos/freeCodeCamp/freeCodeCamp

这是什么

freeCodeCamp.org 背后的代码和课程。README 说 freeCodeCamp.org“is a friendly community where you can learn to code for free”（一个可以免费学编程的友好社区）和“is run by a donor-supported 501(c)(3) charity”（由一家靠捐款运转的 501(c)(3) 慈善组织运营），还说“This code is running live at freeCodeCamp.org”（这段代码正在 freeCodeCamp.org 上运行）。贡献者文档的 FAQ 页说这个平台“runs on a modern JavaScript stack”（用的是现代 JavaScript 技术栈），并列出 Node.js、MongoDB、OAuth 2.0、React、Gatsby 和 Webpack。

仓库顶层的文件夹，按 GitHub 的列表（https://api.github.com/repos/freeCodeCamp/freeCodeCamp/git/trees/main）：

api/ 和 client/：平台的两个部分。package.json 里有 develop:api 和 develop:client 两个脚本来运行它们
curriculum/：课程，以及定下课程顺序的结构文件（见 setup/work-on-curriculum.md）
docker/：启动 MongoDB 和 Mailpit 的 Docker Compose 文件
.devcontainer/：Dev Container 和 GitHub Codespaces 的配置
e2e/：Playwright 端到端测试（package.json：playwright:run）
packages/ 和 tools/：共用代码（课程页面提到了 packages/shared/src/config），以及脚本。package.json 指向 tools/scripts/seed 来灌入数据库，指向 tools/challenge-helper-scripts 来创建新项目，指向 tools/challenge-editor 来用挑战编辑器
sample.env：示例设置，复制成 .env 使用

两种用法

在网站上学习。什么都不用安装：打开 https://www.freecodecamp.org/learn 。见 setup/learn-on-the-site.md。
运行你自己的副本，来改平台或课程。作者的指南讲的是开发环境，不是生产部署。见下面的安装文件。

先要准备什么

作者的本地安装页（https://contribute.freecodecamp.org/how-to-setup-freecodecamp-locally/）为 Local Machine 方式列出这些：

| 需要 | 版本 | 页面上的备注 |
|---|---|---|
| Git | 最新 | 操作系统自带的版本往往已经过时 |
| Node.js | 24.x | 即“Active LTS”版本 |
| pnpm | 12.x | 没有备注 |
| Docker Compose | 2.x | 会替你启动 MongoDB |
| MongoDB Community Server | 8.x | 可选，只有你想不用 Docker 运行 MongoDB 时才需要 |

页面还要求在 macOS 或 Linux 上有 4 个 CPU 核心、8 GB 内存和 10 GB 空闲磁盘。package.json 的 engines 里写着 "node": ">=24" 和 "pnpm": ">=12"，它的 packageManager 字段写的是 pnpm@12.15.0。Dev Container 和 GitHub Codespaces 两种方式不需要你自己装 Node.js 或 pnpm，见它们各自的文件。

各平台的说明

setup/learn-on-the-site.md：不用安装，直接用 freeCodeCamp.org，以及仓库的 README 说那里提供什么
setup/local-machine.md：macOS 和 Linux，来自作者的 Local Machine 标签页
setup/windows-wsl2.md：Windows，安装页说这个项目只支持 macOS 和 Linux，并要求先设置 WSL2
setup/dev-container.md：VS Code、Docker Desktop 和 Dev Containers 扩展
setup/github-codespaces.md：GitHub 服务器上的 codespace，以及它的两个端口陷阱
setup/work-on-curriculum.md：课程文件夹怎么组织，以及构建和测试其中一部分的命令
setup/contribute-a-change.md：Git 工作流、拉取请求的标题格式，以及作者对拉取请求的规定
setup/troubleshooting.md：作者给出的安装失败的解决办法
setup/ai-agents.md：怎么配合 Claude Code、Codex、Cursor 和其他智能体使用（这是 Mindket 的说明，因为作者没有写任何智能体的安装方式）

更新或移除

要更新你的副本，按作者的 Git 工作流做，见 setup/contribute-a-change.md。作者的 pnpm run clean 会“Uninstalls all dependencies and cleans up caches”，意思是卸载所有依赖并清理缓存。文档里没有停止或删除 Docker 容器的命令。compose 文件把项目命名为 freecodecamp-local，并把 MongoDB 的数据放在一个叫 db-data 的卷里，所以两者都用 Docker 自己的工具处理，用完后再删掉你克隆的文件夹。

对外连接

安装会下载依赖和容器镜像。docker/docker-compose.yml 里的 compose 文件用的镜像是 mongo:8.2 和 axllent/mailpit。Dev Container 第一次启动时会下载一个“several gigabytes”（好几个 GB）的预构建镜像。
Mailpit 在 http://localhost:8025 截获你本地副本发出的邮件，而不是通过真正的邮件服务商投递（见贡献者文档里调试发出邮件的那一页）。
sample.env 里有 Auth0、Algolia 和 Stripe 等服务的设置，还把 FORUM_LOCATION、NEWS_LOCATION 和 RADIO_LOCATION 指向 freecodecamp.org 的地址。文档没有列出运行中的本地副本会连接哪些地方，Mindket 也没有运行过。安装页说“The defaults run the app as it is. Change them only if you want your own Auth0, Algolia or Stripe keys.”，意思是：默认值就能让应用跑起来，只有你想用自己的 Auth0、Algolia 或 Stripe 密钥时才改。不要把真正的密钥放进你要分享的文件。
GitHub Codespace 运行在 GitHub 的服务器上，所以你的工作和它转发的端口都在那里。见 setup/github-codespaces.md。

来源

仓库 README：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/README.md
LICENSE.md：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/LICENSE.md
package.json：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/package.json
sample.env：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/sample.env
docker/docker-compose.yml：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/docker/docker-compose.yml
贡献者文档，安装：https://contribute.freecodecamp.org/how-to-setup-freecodecamp-locally/
贡献者文档，WSL：https://contribute.freecodecamp.org/how-to-setup-wsl/
贡献者文档，排错：https://contribute.freecodecamp.org/troubleshooting-development-issues/
贡献者文档，发出的邮件：https://contribute.freecodecamp.org/how-to-catch-outgoing-emails-locally/
贡献者文档，入门：https://contribute.freecodecamp.org/getting-started/
贡献者文档，Git 工作流：https://contribute.freecodecamp.org/basic-git-workflow/
贡献者文档，拉取请求：https://contribute.freecodecamp.org/how-to-open-a-pull-request/
贡献者文档，FAQ：https://contribute.freecodecamp.org/faq/
贡献者文档，课程文件结构：https://contribute.freecodecamp.org/curriculum-file-structure/
贡献者文档，编程挑战：https://contribute.freecodecamp.org/how-to-work-on-coding-challenges/
贡献者文档，工作坊：https://contribute.freecodecamp.org/how-to-work-on-workshops/
贡献者文档，讲解课：https://contribute.freecodecamp.org/how-to-work-on-theory-lessons/
贡献者文档，实验：https://contribute.freecodecamp.org/how-to-work-on-labs/
贡献者文档，课程测试辅助工具：https://contribute.freecodecamp.org/curriculum-help/
.nvmrc：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.nvmrc
仓库根目录的文件列表：https://api.github.com/repos/freeCodeCamp/freeCodeCamp/git/trees/main
.devcontainer/devcontainer.json：https://github.com/freeCodeCamp/freeCodeCamp/blob/main/.devcontainer/devcontainer.json
GitHub 对这个仓库的回答：https://api.github.com/repos/freeCodeCamp/freeCodeCamp

文件

README.md  8 KB
setup/ai-agents.md  4 KB
setup/contribute-a-change.md  5 KB
setup/dev-container.md  3 KB
setup/github-codespaces.md  3 KB
setup/learn-on-the-site.md  4 KB
setup/local-machine.md  5 KB
setup/troubleshooting.md  4 KB
setup/windows-wsl2.md  3 KB
setup/work-on-curriculum.md  6 KB

10 个文件，共 44 KB，以 zip 压缩包下载。