每日一仓

ONE OPEN-SOURCE REPO A DAY

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

第 6 期 · 2026-11-06

EbookFoundation/free-programming-books — 免费编程书的万册图书馆

第 6 期看点:GitHub 上最老牌的免费编程书图书馆——13 年攒下 1 万多条免费资源,47 种语言版本,至今每周还在修死链。

一句话定位

EbookFoundation/free-programming-books 是 GitHub 上最著名的免费编程学习资源清单:不写代码、不做工具,只做一件事——把互联网上真正免费的编程书、课程、互动教程、播客与习题集,按语言和主题整理成一份人人可查、可贡献的目录。它起源于 StackOverflow 上的一张帖子,2013 年由 Victor Felder 搬到 GitHub 协作维护,如今由美国非营利组织 Free Ebook Foundation 管理,是 Atlas 榜上 Star 数第四十万级别的“基础设施型”仓库:你不一定天天打开它,但几乎所有程序员的自学路径都绕不开它。

源码结构

克隆下来实测(git clone --depth 1,仅 3.7MB),仓库共 264 个文件,其中 Markdown 文件 218 个、32,460 行、约 2.26MB——整个仓库就是一份纯文本数据库,代码只有 1 个 Python 脚本:

  • books/(49 个文件,744KB):书单本体。47 种语言版本各一个文件,外加英文的两个索引文件——按编程语言分的 free-programming-books-langs.md(1,633 条,154 节)和按主题分的 free-programming-books-subjects.md(849 条,47 节)。中文版 free-programming-books-zh.md 有 382 条、63 节,Python 一节 19 条,从《简明 Python 教程》到《深入 Python 3》都有;英文 Python 一节则有 174 条。
  • courses/(40 个语言文件,712KB):免费课程清单,4,557 条带链接的条目;英文版 1,468 条、87 节,从 MOOC、算法到区块链按主题分节。
  • casts/(22 个语言文件,124KB):播客与视频课清单,517 条;英文版 262 条。
  • more/(124KB):三类补充清单——速查表 free-programming-cheatsheets.md(371 条)、在线编程练习场 free-programming-playgrounds.md(192 条)、题库与竞赛编程 problem-sets-competitive-programming.md(132 条),以及 6 个语言版本的互动教程。
  • docs/(94 个文件,976KB):治理文档的翻译矩阵——行为准则译成 32 种语言,投稿指南 23 种,新手上路指南(HOWTO)35 种。一个清单仓库配这么多语言的治理文档,本身就说明贡献者来自全球。
  • scripts/rtl_ltr_linter.py(27KB):全仓库唯一的“代码”,一个检查 Markdown 里从右向左(RTL)与从左向右(LTR)文字混排问题的 Python 脚本。这也是 GitHub 把仓库主语言标为 Python 的原因——内容全是 Markdown,唯一可执行的就是它。
  • .github/workflows/(7 个工作流):PR 检查、死链检查、RTL/LTR 检查、冲突 PR 检测、过期 Issue 处理、Issue 置顶管理。
  • 根目录:README.md(240 行,16KB)是总入口,另有 _config.yml(Jekyll 配置)、.editorconfig、CC-BY-4.0 的 LICENSE(18KB)。

全库带链接的资源条目共 10,751 条(books 4,777 + courses 4,557 + casts 517 + more 900),这是逐行数出来的实测数字,不是 README 上的宣传口径。

架构图

flowchart TD
    A[读者入口 README 与搜索站] --> B[内容层 四大清单库]
    B --> C[书单 books 47 种语言]
    B --> D[课程 courses 40 种语言]
    B --> E[播客 casts 22 种语言]
    B --> F[补充 more 速查表与题库]
    C --> G[英文双索引 按语言与按主题]
    C --> H[各语言版 如中文版 382 条]
    G --> I[治理层 投稿格式与免费标准]
    H --> I
    I --> J[自动化层 PR 检查与死链检查]
    J --> K[托管层 GitHub 与 Jekyll 静态站]
    A --> K

分层设计说明

按实际文件可以分成五层,每层各管一摊:

  • 入口层:根目录 README.md 是总目录,指向各语言清单、Jekyll 静态站(ebookfoundation.github.io/free-programming-books)和一个独立的动态搜索站(free-programming-books-search)。三种入口对应三种找法:按语言浏览、按页面浏览、按关键词搜索。
  • 内容层:四大清单库按资源形态划分——书、课程、播客/视频、补充清单(速查表、练习场、题库、互动教程)。CONTRIBUTING.md 把六种清单的定义写得很死:书是 PDF/HTML/ePub/GitBook 形态的读物,课程是“不是书的学习材料”,互动教程必须能在线写代码并得到反馈,练习场必须能写、编译、分享代码片段。定义先行,投稿时先对号入座,分类才不会乱。
  • 语言层:每种语言一个文件,英文再拆成“按语言”和“按主题”两个索引文件。中文版 63 节里既有“版本控制”“编译原理”这类主题节,也有 Android、Python、Web 这类语言节——中英文版的分类口径并不强求一致,各语言社区按自己的阅读习惯组织。
  • 治理层:docs/ 里的 CONTRIBUTING、行为准则与 HOWTO 构成投稿规则:只收真正免费的内容(要邮箱才能下载的不收)、链接要最权威的源(作者官网优先于出版社、出版社优先于第三方)、优先 https、禁网盘与文件托管站链接(Google Drive、Dropbox、Mega、Scribd、Issuu 一律不收)、条目按字母序排列、格式固定为 * [书名](链接) - 作者,未完成标注 in process、从互联网档案馆恢复的标注 archived。
  • 自动化层:规则不是靠人工背下来的。PR 触发 fpb-lint 工作流,用 npm 包 free-programming-books-lint 检查字母序与格式;check-urls 工作流在每次 push 与 PR 时只检查改动过的文件里的链接(矩阵并行,最多 10 路);rtl-ltr-linter 检查阿拉伯语、波斯语等 RTL 语言文件里的方向混排问题;另有检测冲突 PR、过期 Issue 自动关闭的工作流。
  • 托管层:GitHub Pages + Jekyll(minimal 主题,kramdown 渲染)把 Markdown 直接变成可读网站,零服务器、零构建脚本,仓库本身就是网站源。

技术亮点

亮点一:把“免费”做成可执行的判定标准,而不是一句口号。 很多清单仓库写着“免费资源”,实际混进不少要注册、要邮箱、要付费墙的内容。这个仓库的 CONTRIBUTING 把免费的边界写成了检查清单:要求邮箱才能下载的不收,文件托管站链接不收,投稿时最好在 PR 里说明“为什么我认为它是免费的”。配合 check-urls 工作流每次只检查改动文件的链接,死链在合入前就被拦下——最新提交就是 2026-11-01 修掉一条 Web Audio API 书的死链(PR #13579)。代价是维护成本:1 万多条链接靠志愿者与自动化轮流巡检,open issue 仍有 101 个,说明死链与过期内容是常态,只能持续修、修不完。

亮点二:用“一个文件一种语言”解决多语言协作的冲突问题。 47 种语言版本各占一个文件,投稿改中文版不会碰英文版,改阿拉伯语版不会碰波斯语版——这对一个每月有上百个 PR 的仓库至关重要。冲突仍然会发生(多人同时改同一语言文件),所以配了 detect-conflicting-prs 工作流自动给冲突 PR 打标签。配合“原子提交”(一次提交只做一次增删改)的约定,合并成本被压到最低。边界也很清楚:这种按语言切文件的办法只适合条目彼此独立的清单;一旦条目之间有交叉引用(比如同一本书的中英两个版本),文件切分就帮不上忙,得靠人工在 PR 里说明。

亮点三:把“可读性”当成工程问题,用 CI 而不是靠自觉。 条目格式、字母序、空行规则(节与节之间空两行、标题与首条之间空一行、条目之间不空行)全部由 free-programming-books-lint 在 PR 里自动检查;RTL 语言的混排问题有专用 Python 脚本检查;链接有效性有 check-urls 检查。三层检查叠加的效果是:一个 13 年、约 3,598 位贡献者的仓库,内容格式至今保持统一,13,579 个 PR 能被持续合入而不走样。代价是新人投稿门槛:第一次投稿的人要先读 CONTRIBUTING,格式不对 CI 就打回——HOWTO 文档被译成 35 种语言,多少也是为了降低这道门槛。

值得参考的设计或实现

  • “定义先行”的清单治理:六种资源先给定义再接受投稿,分类争议发生时有据可查。自己维护清单、知识库、awesome 列表时,先写一页“什么算、什么不算”比事后返工便宜得多。
  • 只检查改动部分的 CI:check-urls 用 changed-files 取出本次改动的文件再逐个验链,而不是每次全量扫 1 万多条链接——增量检查是大清单仓库保持 CI 快速的关键,值得抄走。
  • 把“免费”与“权威源”写进投稿模板:投稿指南明确要求优先作者官网、优先 https、去掉 URL 末尾斜杠与短链接、过期证书的链接降级 http 或删除。这些都是小规则,但 1 万多条链接的质量就是靠它们一行行攒出来的。
  • 翻译即治理:行为准则 32 种语言、投稿指南 23 种、新手指南 35 种——多语言翻译不是面子工程,是让全球贡献者用母语读懂规则、敢于投稿的实际手段。社区规模越大,规则翻译的回报越高。
  • 零成本托管:Jekyll + GitHub Pages,仓库即网站源,没有服务器、没有数据库、没有部署流程。内容型项目想长期活下去,先把运维成本降到零。

适合谁

  • 正在自学编程、想找一本免费好书入门的人:按语言进对应文件,Python、JavaScript、Go、Rust 各有专节,中文版 382 条足够从零开始。
  • 想系统补基础的人:英文按主题索引里有算法与数据结构、编译原理、计算机组成、人工智能、区块链、云计算等 47 个主题节,都是语言无关的经典书单。
  • 带新人、做培训、写技术专栏的人:这份清单是现成的“免费教材货架”,CC-BY-4.0 许可下注明来源即可引用和再分发。
  • 想给开源做第一次贡献的人:改一条死链、补一本新书就是一次有效 PR,仓库有 35 种语言的新手指南,门槛是 GitHub 上最低的一档。

怎么上手

  • 直接读:打开 https://github.com/EbookFoundation/free-programming-books ,按语言找对应文件;中文读者直接看 books/free-programming-books-zh.md,英文读者看 free-programming-books-langs.md(按语言)或 free-programming-books-subjects.md(按主题)。
  • 搜索:README 顶部的搜索站可以按书名或作者检索,比在文件里 Ctrl+F 更快。
  • 课程与视频:courses/ 找免费课程(英文版 1,468 条),casts/ 找播客与视频课,more/ 里有速查表、在线练习场与题库。
  • 贡献:先读 docs/CONTRIBUTING.md,确认资源真正免费、格式为 * [书名](链接) - 作者、按字母序插入对应小节,然后提 PR;CI 会自动检查格式与链接。不会 Git 也可以先开 Issue 贴链接,由维护者代为加入。
  • 本地离线查:git clone --depth 1 https://github.com/EbookFoundation/free-programming-books.git,3.7MB,218 个 Markdown 文件全在本地,grep 就能全文检索。

数据卡

  • 仓库:EbookFoundation/free-programming-books(https://github.com/EbookFoundation/free-programming-books)
  • Star:400,978(实时,2026-11-06)
  • Fork:67,187
  • 主要语言:Python(GitHub 判定;实际内容为 Markdown,唯一代码是 RTL/LTR 检查脚本)
  • 许可证:CC-BY-4.0(Creative Commons Attribution 4.0 International)
  • Atlas 分类:学习资源与 Awesome;领域:软件开发
  • 创建时间:2013-10-11
  • 最近更新:2026-11-05;最近一次提交:2026-11-01(修复 Web Audio API 书的死链,PR #13579)
  • 订阅者:9,775;未关闭 Issue:101;贡献者:约 3,598 位
  • 规模实测:克隆 3.7MB,264 个文件,218 个 Markdown 文件,32,460 行;带链接的资源条目 10,751 条(书 4,777、课程 4,557、播客 517、补充 900)
  • 官网:https://ebookfoundation.github.io/free-programming-books/

← 返回仓库目录