摘要
一句话总结
《程序员做饭指南》（HowToCook）是一个专为程序员设计的开源菜谱项目，通过精准量化的指令替代传统菜谱中的模糊描述，并支持网页浏览、PDF下载和 Docker 本地部署。
关键要点
- 版本与协议：最新版本为 1.5.0（发布于 2025-06-15），采用 Unlicense 开源协议。
- 精准量化描述：摒弃传统菜谱中“适量”、“少许”等模糊用词，采用类似形式语言的精确度量和严谨逻辑来指导烹饪。
- 标准化菜谱库：提供大量荤素菜品做法，并按照操作难度进行了 1 星到 5 星的索引分类。
- 基础理论与技巧：包含厨房准备、食品安全等基础知识，并提供高压锅、空气炸锅等设备使用指南，以及焯水、煎、炒、蒸、煮等烹饪手法教学。
- 多端阅读与部署：支持在线网页查阅、离线 PDF 下载，以及通过拉取官方镜像（
ghcr.io/anduin2017/how-to-cook:latest）进行 Docker 容器化本地部署。 - 社区驱动与贡献：开源社区持续维护，贡献者可使用项目提供的统一 Markdown 模板（
示例菜.md）编写新菜谱并提交 PR。
风险与不足
- 语言限制：该指南目前仅提供简体中文版本（Simplified Chinese only）。
- 数据不一致：文档记录的参考 Stars 数量（22967）与 GitHub API 抓取显示的公开 Stars 数量（98098）存在不一致。
功能与定位
本项目是一个专为程序员编写的“在家做饭指南”。其核心定位是解决传统菜谱中常见的模糊描述（如“适量”、“少许”、“莫名出现的材料”）问题，转而采用清晰、精准、类似形式语言的描述方式来整理常见菜品的做法，使其对程序员群体更加友好。该项目由社区驱动并持续维护。
典型使用场景
- 习惯精确指令和量化描述的人群（如程序员）在家做饭时作为菜谱参考。
- 烹饪新手学习基础的厨房准备、设备使用及食材处理技巧。
- 开发者通过 Docker 部署个人的本地菜谱 Web 服务。
核心功能
- 标准化菜谱库：提供大量常见菜品的做法，分为“素菜”和“荤菜”两大类，涵盖从家常菜（如西红柿炒鸡蛋、酸辣土豆丝）到硬菜（如红烧肉、水煮牛肉）的详细步骤。
- 难度分级系统：菜谱按照操作难度进行了 1 星到 5 星的索引分类，方便用户根据自身水平选择。
- 基础烹饪理论与技巧：包含专门的
tips目录，提供厨房准备、如何选择吃什么、食材相克与禁忌、食品安全等基础知识。 - 设备与手法教学：针对高压力锅、空气炸锅、微波炉等设备提供使用指南；针对去腥、焯水、炒、煎、凉拌、腌、蒸、煮等烹饪手法提供专项学习文档。
- 多端阅读与部署：支持在线网页浏览、PDF 文档离线下载，以及通过 Docker 容器化部署本地 Web 服务。
特色与差异点
- 精准的量化描述：摒弃传统菜谱的模糊用词，结合实际做菜经验，用严谨的逻辑和精确的度量指导烹饪。
- 开源社区驱动：任何人都可以通过 GitHub 提交 Pull Request 修复问题或贡献新菜谱。
- 统一的菜谱模板：项目提供了标准化的 Markdown 菜谱模板，确保所有贡献的菜谱在格式和描述风格上保持高度一致。
使用方式概览
- 在线查阅：直接访问项目主页或 GitHub 仓库内的 Markdown 文件阅读菜谱。
- 本地部署：安装 Docker 后，拉取官方镜像
ghcr.io/anduin2017/how-to-cook:latest并运行，即可在本地搭建菜谱 Web 服务。 - 离线阅读：通过官方提供的链接下载 PDF 版本的指南。
- 参与贡献：复制项目中的
示例菜.md模板，按规范编写新菜谱后提交 PR。
限制与注意事项
- 语言限制：该指南目前仅提供简体中文版本（Simplified Chinese only）。
链接
- 项目页：https://github.com/Anduin2017/HowToCook
- 首页：https://cook.aiursoft.com
- PDF 下载：https://cook.aiursoft.com/document.pdf
- 最新 Release：https://github.com/Anduin2017/HowToCook/releases/tag/1.5.0