Totoro-jam/battle-tested-patterns
Totoro-jam/battle-tested-patterns has 344 GitHub stars and 42 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-19 03:02 UTC. Last push 2026-09-04.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Battle-tested programming patterns from production codebases — React, Linux, Go, Chromium, and more. Precise source links, multi-language examples, runnable exercises.
网站与应用README.zh-CN.md
原文Battle-Tested Patterns
从顶级开源项目源码中提炼的代码级编程模式。
交互式可视化(支持时间旅行回放)· 精确到行号的源码链接 · 多语言实现 · 可运行练习
English | 简体中文
46 个模式速览
🧠 数据结构
|
⚡ 并发
|
🏗️ 系统
|
♻️ 内存
|
🔄 行为型
|
📊 验证来源
|
填补什么空白
| 现有资源 | 缺失的部分 |
|---|---|
| 设计模式书 | 太抽象,过于 OOP |
| 算法仓库 | 脱离工程实践 |
| 系统设计指南 | 架构层面,不涉及代码级 |
本项目:从 React、Linux、Go、Chromium 等项目中提取的代码级技巧——每个都有可验证的源码链接。
编程模式
每个"验证来源"链接都指向源代码的精确行号。不是目录,不是文件,是行。
模式长什么样
每个模式遵循一致的结构——以位掩码为例:
比特位: 7 6 5 4 3 2 1 0
┌────┬────┬────┬────┬────┬────┬────┬────┐
标志: | │ │ │ SN │ CB │ RF │ UP │ PL │
└────┴────┴────┴──┬─┴──┬─┴──┬─┴──┬─┴──┬─┘
│ │ │ │ └── Placement (1 << 0)
│ │ │ └─────── Update (1 << 1)
│ │ └──────────── Ref (1 << 2)
│ └───────────────── Callback (1 << 3)
└────────────────────── Snapshot (1 << 4)
4 种语言实现,各自地道:
// TypeScript // Python
const READ = 1 << 0; READ = 1 << 0
const WRITE = 1 << 1; WRITE = 1 << 1
const perms = READ | WRITE; perms = READ | WRITE
(perms & READ) !== 0; // true bool(perms & READ) # True
然后是 2 个难度等级的练习——全部配套可运行测试。
项目亮点
| 特性 | 详情 |
|---|---|
| 46 个模式 | Bitmask、LRU Cache、MVCC、Work Stealing、Actor Model 等 |
| 46 个交互式可视化 | 可点击、可拖拽的 SVG 可视化,动手操作建立直觉,还能用播放栏撤销或回放任意步骤 |
| 93 个 TS 练习 + 每语言 46 个 | 4 种语言(TS/Rust/Go/Python),共 1,073+ 个测试用例 |
| 184 个挑战题 | "你猜会怎样"场景问答,验证真正理解 |
| 9 个系统案例 | React、Linux、Go、Git、Node.js、Rust、游戏引擎、分布式系统如何组合模式 |
| 4 种语言 | TypeScript、Go、Python、Rust 地道实现 |
| 双语 | 完整中英文文档 |
| 学习指南 | 学习路径 · 复杂度速查表 · 模式对比 · 学习计划 |
快速开始
前置依赖
| 工具 | 版本 | 用途 |
|---|---|---|
| Node.js | ≥ 22 | 文档站、TypeScript 练习 |
| pnpm | ≥ 9 | 包管理器 |
| Rust | stable | Rust 练习(可选) |
| Go | ≥ 1.23 | Go 练习(可选) |
| Python | ≥ 3.10 | Python 练习(可选) |
git clone https://github.com/Totoro-jam/battle-tested-patterns.git
cd battle-tested-patterns && pnpm install
# 运行任意语言的练习
pnpm test:exercises # 全部 4 种语言(TS/Rust/Go/Python)
pnpm test:ts # 仅 TypeScript(491 个测试,Vitest)
pnpm test:rust # 仅 Rust(173 个测试)
pnpm test:go # 仅 Go(176 个测试)
pnpm test:python # 仅 Python(233 个测试)
pnpm test # 运行全部测试:docs 组件 + 4 种语言的练习
pnpm dev # 本地文档站
各语言详细设置请参考练习指南。
Agent 技能
两个 Agent 技能可让 AI 编码助手与模式目录协同工作:
- adopt-pattern — 根据问题找到合适的模式,并将其适配到你的代码中(附回归测试)
- audit-pattern — 对照目录审计现有代码库中的模式实现,标记误用
通过 Claude Code 插件市场安装:
/plugin marketplace add Totoro-jam/battle-tested-patterns
/plugin install pattern-skills@battle-tested-patterns
或使用 npx skills 安装器(支持 Claude Code、Codex、Copilot 等):
npx skills add Totoro-jam/battle-tested-patterns/plugins/pattern-skills
两个技能在运行时获取模式文档 URL,因此你也可以不安装直接调用——它们会从仓库读取目录。
参与贡献
详见 CONTRIBUTING.md。门槛不低:
- ≥ 2 个生产验证 — 精确到行号的已验证源码链接
- TypeScript + ≥ 1 种其他语言 — 地道实现,不是翻译
- 4 种语言的练习文件(TS/Rust/Go/Python)+ 答案文件
- 中文翻译且代码块一致
- 所有测试通过(
pnpm test一次运行 4 种语言 + docs),无 lint 错误 - 源码链接每周由 CI 自动检查——失效链接自动开 Issue
贡献者
Totoro-jam 💻 📖 🎨 🚧 🤔 |
Raymond Feng 💻 📖 🤔 |
小朝 🐛 |
本项目遵循 all-contributors 规范。欢迎任何形式的贡献!
Star History
许可证
MIT © Totoro-jam