每日一仓

ONE OPEN-SOURCE REPO A DAY

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

第 8 期 · 2026-11-08

donnemartin/system-design-primer — 系统设计面试的开源通关手册

第 8 期:donnemartin/system-design-primer——37.7 万 Star 的系统设计面试开源教材,把"设计大型系统"拆成可读、可练、可背的一份学习仓库。

一句话定位

这是一个帮人准备系统设计面试的开源学习仓库:主文档是一份 1,839 行的系统设计主题手册,配 8 道带题解的系统设计面试题、6 道面向对象设计题、3 副 Anki 记忆卡组和 4 种语言的翻译版,目标是让读者在面试里能自己主导一场开放式系统设计讨论。

源码结构

实测是浅克隆(git clone --depth 1)的结果:检出 169 个文件,共约 24 MB。仓库的体量基本都在文档上:

  • 主文档:README.md 1,839 行、约 110 KB,含 29 个二级小节、82 个三级小节,内嵌 381 个外部链接,images/ 目录下 36 张架构示意图(8.5 MB)。
  • 多语言版:日文、简体中文、繁体中文三份完整翻译(分别为 137 KB、101 KB、126 KB),另有 TRANSLATIONS.md 登记翻译状态。
  • 题解:solutions/ 下 8 道系统设计题(Pastebin、Twitter 时间线与搜索、网络爬虫、Mint、社交图谱、搜索引擎键值缓存、亚马逊销量排名、AWS 百万用户扩容)加 6 道面向对象设计题(哈希表、LRU 缓存、呼叫中心、扑克牌、停车场、聊天服务器),题解 Markdown 共 5,707 行,另有 6 个 Jupyter 笔记本(.ipynb)。
  • 代码:Python 源码 12 个文件、共 1,062 行,集中在 solutions/ 里;全仓 Markdown 合计 13,166 行。
  • 记忆工具:resources/flash_cards/ 下 3 个 Anki 牌组文件(系统设计、系统设计习题、面向对象设计),合计约 127 KB;另有学习指南图 resources/study_guide.png。
  • 输出工具:generate-epub.sh 用 pandoc 把主文档和各题解拼成 EPUB 电子书,并为三种翻译各生成一本。

架构图

flowchart TB
    A[入口 README.md] --> B[学习路径层]
    B --> C[知识层 系统设计主题]
    B --> D[方法层 四步面试法]
    C --> E[实战层 系统设计题解]
    C --> F[实战层 面向对象题解]
    E --> G[记忆层 Anki 卡组]
    F --> G
    G --> H[输出层 EPUB 电子书]
    A --> I[翻译层 多语言版本]
    A --> J[附录 估算工具表]

分层设计说明

仓库按"读—练—背—输出"四层组织,层与层之间是单向依赖,读完上层再进入下层:

  • 入口层:README.md 既是目录也是正文。开头先讲动机和 Anki 卡组,随后是"主题索引"总目录,再进入"如何应对系统设计面试题"的方法论,最后才是 29 个主题小节和附录。
  • 学习路径层:Study guide 一节按短、中、长三种备考时间线给出一张任务表——短时间线求广度、读主题、做几道题;长时间线在广度之外再加深度和公司工程博客。明确写着"不需要什么都懂",按经验、岗位、目标公司调整。
  • 知识层:从"性能 vs 可扩展性""延迟 vs 吞吐量""可用性 vs 一致性"三组基本对立概念起手,依次讲一致性模式、可用性模式、DNS、CDN、负载均衡、反向代理、应用层、数据库、缓存、异步、通信、安全。每个主题都按"定义—利弊—延伸阅读"的固定格式写,索引里直接标明"一切都是权衡"。
  • 实战层:8 道系统设计题各有一份独立题解(如 Twitter 题解 333 行、爬虫题解 353 行、AWS 扩容题解 403 行),每份题解配示意图;6 道面向对象题各有一个 Python 实现加一份 Jupyter 笔记本。
  • 记忆层与输出层:Anki 卡组用间隔重复帮读者记住概念;generate-epub.sh 把主文档和题解合并输出 EPUB,方便离线阅读。

技术亮点

亮点一:每个主题都写成"利弊对照表",而不是知识点罗列。 以缓存一节为例,README 里逐一对比了客户端缓存、CDN、Web 服务器缓存、数据库缓存、应用缓存五种位置,再对比 Cache-aside、Write-through、Write-behind、Refresh-ahead 四种写入策略,并写明各自的代价(比如 Write-behind 实现比前两种复杂)。这种写法的好处是面试时能直接拿来做取舍论证;代价是内容量大,主文档 381 个外链里很多是指向延伸阅读的,通读一遍需要按周计的时间投入。

亮点二:附录里两张"心算表"是面试估算的硬工具。 "2 的幂表"从 2^7=128 一直列到 2^32≈43 亿;"每个程序员都该知道的延迟数字"表给出实测量级:L1 缓存 0.5 纳秒、内存访问 100 纳秒、同数据中心往返 500 微秒、磁盘寻道 10 毫秒、跨大西洋发包 150 毫秒。配合"如何应对面试题"一节里的 back-of-the-envelope(信封背面估算)要求,读者可以用这两张表在白板上现场算出 QPS、存储量和带宽。边界也很清楚:这些是 2017 年左右的典型值,SSD、网络硬件的数字今天已有变化,只能当量级参考,不能当精确报价。

亮点三:代码是"留空的练习骨架",不是现成答案。 实测 solutions/object_oriented_design/lru_cache/lru_cache.py 只有 66 行:Cache 类的 get/set 逻辑写全了,但底层的 LinkedList 三个方法 move_to_front、append_to_front、remove_from_tail 全是 pass,要读者自己补完;solutions/system_design/pastebin/pastebin.py 的 MapReduce 作业 HitCounts 也是同样套路,mapper/reducer 骨架已定,extract_url 和 extract_year_month 两个抽取函数留空。设计意图很清楚:题解文档讲思路,代码文件留给读者动手。顺带一提,代码质量本身并不严谨——lru_cache.py 里 Node.__init__ 写的是 self.next = next,把内置函数 next 赋给了实例属性,属于小毛病;把它当面试思路参考没问题,直接照搬进生产代码则不行。

值得参考的设计或实现

  • 翻译治理的三档状态机:TRANSLATIONS.md 把每种语言标为 Live(已合入 master)、In Progress(有人在翻)、Stalled(停滞)三档,并写明判定规则——过去 2 个月翻译 fork 无进展且讨论串无人发言即判 Stalled。目前日文、简体中文、繁体中文三语 Live,韩文、俄文 In Progress,阿拉伯文、法文、德文等 14 种语言 Stalled 且标注"Help Wanted"。每种语言都登记维护者 GitHub 账号和对应的 issue 讨论串编号。做多语言开源项目可以直接抄这套登记格式。
  • PR 模板强制的翻译流程:.github/PULL_REQUEST_TEMPLATE.md 要求翻译类 PR 必须在标题前加语言代码(如 ja: Fix ...),并 @ 对应语言的维护者。配合 CONTRIBUTING.md,新贡献者不用猜流程。
  • "一源多输出"的发布脚本:generate-epub.sh 只有约 40 行,先检查 pandoc 是否安装,再把 README.md 和 solutions/system_design/*/ 下各题解的 README 拼成一个临时文件生成英文 EPUB,再为日、简中、繁中各生成一本。小项目想把 Markdown 文档变成电子书,这段脚本就是可直接复用的模式。
  • 间隔重复进学习仓库:一般技术仓库只给文档,这个仓库把 Anki 牌组当成一等公民放在 resources/flash_cards/,并在 README 开头就推荐"路上用"。把记忆工具纳入仓库交付物,是它区别于一般面试资料的关键设计。

适合谁

  • 准备大厂系统设计面试的工程师:按 Study guide 的短/中/长三档时间线走,先读主题索引建立广度,再挑 8 道题解练"四步法"(明确用例与约束—画高层设计—深入核心组件—讨论扩容)。
  • 刚接触后端架构的开发者:主题手册从 DNS、CDN、负载均衡这些基础概念讲起,每节都有利弊和延伸阅读,适合当第一本系统设计入门读物。
  • 中文读者:直接读 README-zh-Hans.md(简体中文完整翻译,1,793 行),不用先啃英文版。
  • 不适合的人:想找可直接运行的系统代码的人——这个仓库的代码量只有 1,062 行且多为练习骨架;想学某一具体技术(如 Kubernetes、Kafka 实操)的人——它讲的是通用设计原则,不讲具体产品的配置与运维。

怎么上手

  1. 打开仓库主页,先读"Study guide"一节,按自己的面试时间线(短/中/长)定计划。
  2. 通读"System design topics: start here"两步入门(可扩展性视频讲座 + 文章),再按索引挑自己弱的主题精读。
  3. 用"How to approach a system design interview question"里的四步法,逐题过 solutions/system_design/ 下的 8 道题:先自己画设计,再对照题解;面向对象 6 道题则把 solutions/ 里留空的 pass 方法自己补全。
  4. 把 resources/flash_cards/ 下的 3 个 .apkg 文件导入 Anki,利用碎片时间复习概念。
  5. 想离线读,装 pandoc 后运行 ./generate-epub.sh,直接生成 EPUB 电子书。

数据卡

  • 仓库:donnemartin/system-design-primer
  • Star:377,262(实时,2026-11-08 查询;Atlas 快照为 376,170)
  • Fork:59,211
  • 主要语言:Python(标注语言;实际内容以 Markdown 文档为主)
  • 许可证:CC BY 4.0(LICENSE.txt;GitHub API 未识别 SPDX,显示为 NOASSERTION)
  • Atlas 分类:学习资源与 Awesome;领域:产品与设计
  • 创建时间:2017-02-26
  • 最近推送:2026-09-15;最近更新:2026-11-07
  • 未关闭 issue:641
  • 默认分支:master

← 返回仓库目录