Hello Algo《Hello 算法》

Hello Algo：安装说明

这个工具包里只有安装说明，由 Mindket 编写。书、它的动画图解和它的代码都留在 krahets/hello-algo 仓库里，地址是 https://github.com/krahets/hello-algo

这些说明不是 krahets 写的，也没有得到 krahets 的认可。英文 README 称这本书是“A data structures and algorithms tutorial with animated illustrations and code you can run with one click”，意思是：一本动画图解、代码可一键运行的数据结构与算法教程。它还说“This project aims to create a free, open-source introduction to data structures and algorithms that is accessible to beginners.”，意思是：这个项目想做一本免费、开源、对初学者友好的数据结构与算法入门书。中文版的书名是《Hello 算法》。这些说明依据英文和简体中文的 README、英文版的文档页面和两个简体中文页面、仓库的 Docker 文件和 giscus.json、它在 GitHub 上的发布页、GitHub 的仓库 API 和它的文件夹列表写成，都在 2026 年 11 月 3 日读取。

许可证：仓库自己的许可证是 CC BY-NC-SA 4.0。README 的 License 一节写着“The texts, code, images, photos, and videos in this repository are licensed under CC BY-NC-SA 4.0.”，意思是：这个仓库里的文字、代码、图片、照片和视频都按 CC BY-NC-SA 4.0 授权。LICENSE 文件是 Creative Commons 的法律文本，第一行是“Attribution-NonCommercial-ShareAlike 4.0 International”。GitHub 对这个仓库的回答把许可证标为“Other”，SPDX 编号是 NOASSERTION。许可证名称里有 NonCommercial（非商业）和 ShareAlike（相同方式共享）。如果你打算把书里的文字、图片或代码用到你要出售的东西里，请先读 LICENSE 里的法律文本。这些说明只引用书里的几句短话，并写明每一句出自哪一页，里面没有书的图片或代码。

这是什么

一本写给初学者的免费数据结构与算法书，由 krahets 和许多贡献者写成。英文 README 说“Animated illustrations throughout the book, clear explanations, and a gradual learning curve guide beginners through data structures and algorithms.”，意思是：全书用动画图解，讲解清楚，学习曲线平缓，带初学者走进数据结构与算法。它还说“Code that runs with one click helps readers build programming skills through practice and understand how algorithms work and how data structures are implemented.”，意思是：可以一键运行的代码帮助读者在练习中提高编程能力，并弄懂算法怎么工作、数据结构怎么实现。来源见 https://github.com/krahets/hello-algo/blob/main/en/README.md

书里的代码块顶部标有文件名时，“How to use this book”一页说，你可以在仓库的 en/codes 文件夹里找到那个文件。见 setup/run-the-code.md。

书的各章，按英文版目录的编号：

| 章 | 标题 |
|---|---|
| 0 | Preface（前言） |
| 1 | Getting to know algorithms（初识算法） |
| 2 | Complexity analysis（复杂度分析） |
| 3 | Data structures（数据结构） |
| 4 | Arrays and linked lists（数组与链表） |
| 5 | Stacks and queues（栈与队列） |
| 6 | Hash tables（哈希表） |
| 7 | Trees（树） |
| 8 | Heaps（堆） |
| 9 | Graphs（图） |
| 10 | Searching（搜索） |
| 11 | Sorting（排序） |
| 12 | Divide and conquer（分治） |
| 13 | Backtracking（回溯） |
| 14 | Dynamic programming（动态规划） |
| 15 | Greedy algorithms（贪心算法） |
| 16 | Appendix（附录：编程环境、参与本书、术语表） |

目录里在第 0 章前面还有一篇 Foreword（序），在第 16 章后面还有一页 References（参考文献）。来源见 https://github.com/krahets/hello-algo/blob/main/en/mkdocs.yml

仓库里有六种语言的书：简体中文在根目录，其余是繁体中文（zh-hant）、英文（en）、日文（ja）、俄文（ru）和韩文（ko）文件夹。README 的语言栏列出了这六个版本，并链接了其余五个。

会安装什么

读书的话什么都不用装。要运行书里的代码，你要装一个语言环境，附录会说是哪一个。见 setup/language-environments.md。要自己架一份网站，需要 Docker。见 setup/docker.md。

事先需要准备

• 在线阅读，或者读 PDF、EPUB：一个浏览器或电子书阅读器。
• 运行代码：Git（或者 GitHub 上的 Download ZIP 按钮）、一个编辑器，以及你选的那种代码语言的语言环境。书里推荐 VS Code。Python 需要 3.10 或更高版本。
• 自己架一份网站：Docker 和 Docker Compose。

各平台的说明

• setup/read-online.md：网站、它的各种语言、它的搜索，以及书里自己给的阅读建议
• setup/download-pdf-epub.md：GitHub releases 页面上的 PDF 和 EPUB 文件
• setup/run-the-code.md：克隆仓库，找到代码块上方标出的文件并运行，附一个 Python 示例
• setup/language-environments.md：附录给出的各种代码语言的搭建步骤
• setup/docker.md：根目录里构建网站的 Docker 文件，以及 en/codes 里为英文版代码准备的 Docker 文件（每个版本的代码文件夹里都有这样一组）
• setup/contribute-and-translate.md：书里说的怎么改一页、补一种代码语言或参与翻译

作者没有写任何编程智能体的用法：README 和读过的文档页面都没有提到。

更新或卸载

克隆下来的仓库用普通的 Git 更新，ZIP 只是一份快照，所以以后有改动要重新下载（Mindket 的说明）。要删除克隆或 ZIP，删掉那个文件夹。在线阅读什么都不装。Docker 部署有它自己的移除命令，见 setup/docker.md。

对外连接

• 读网站会加载 www.hello-algo.com。网站的配置从 cdnjs.cloudflare.com 加载 MathJax（en/mkdocs.yml 的 extra_javascript）。
• 书里 Python 代码的“可视化运行”按钮会用到 pythontutor.com，“How to use this book”一页就是这么说的。
• README 里的图片从 img.shields.io、readme-typing-svg.demolab.com 和 contrib.rocks 加载。
• git clone 和 releases 下载会连到 GitHub。
• Docker 构建会拉取一个基础镜像，网站那一组还会从 PyPI 安装 Python 包。代码镜像通过阿里云的 apt 镜像安装操作系统软件包，C# 则从 Microsoft 的软件包仓库安装。细节见 setup/docker.md。

来源

• README：https://github.com/krahets/hello-algo/blob/main/README.md（简体中文）和 https://github.com/krahets/hello-algo/blob/main/en/README.md（英文）
• LICENSE：https://github.com/krahets/hello-algo/blob/main/LICENSE
• How to use this book：https://github.com/krahets/hello-algo/blob/main/en/docs/chapter_preface/suggestions.md
• About this book：https://github.com/krahets/hello-algo/blob/main/en/docs/chapter_preface/about_the_book.md
• Setting up a programming environment：https://github.com/krahets/hello-algo/blob/main/en/docs/chapter_appendix/installation.md
• Contribute to the book：https://github.com/krahets/hello-algo/blob/main/en/docs/chapter_appendix/contribution.md
• 英文版的网站配置：https://github.com/krahets/hello-algo/blob/main/en/mkdocs.yml
• Releases：https://github.com/krahets/hello-algo/releases
• 英文版的贡献指南：https://github.com/krahets/hello-algo/blob/main/en/CONTRIBUTING.md
• Dockerfile 和 docker-compose.yml：https://github.com/krahets/hello-algo/blob/main/Dockerfile 和 https://github.com/krahets/hello-algo/blob/main/docker-compose.yml
• 英文版的代码文件夹和它的 Docker 文件：https://github.com/krahets/hello-algo/tree/main/en/codes
• GitHub 对这个仓库的回答：https://api.github.com/repos/krahets/hello-algo