一个文件的开源项目，开启你的开源之旅

你是否记得：刚学完编程基础那会儿，特别想写个东西，但动起手来却发现到处碰壁？

你是否找到：一个好玩的开源项目，结果卡在了部署环境、安装依赖上？最后"含恨而终"！

我刚学编程的时候，不止一次打开 IDE 看着闪动的光标发呆，大脑和空白的页面一样，一片空白毫无头绪。想写点东西根本无从下手，想玩别人的项目也跑不起来。一下子从书本抄代码的阶段，转变到自己构思、设计、编写代码，这跨度着实有些大。当时感觉自己学的那些什么语法规则，都吃完拉了什么都没留下。

有没有人和我一样，有过上面的经历或者正处于这种状态。我当时就在想有没有那种，比书上的实例代码长一些，有些实际用途的开源项目。即：

一个文件、运行简单、一看就懂，有趣的开源项目！

因为一个文件的项目基本上复制代码到编辑器里就能跑，还可以通过调试看每步的结果更容易读懂代码。重点是它要有实际用途，不是代码例子，这样就可以拿出去给别人看和使用，学起来很有动力。代码中再多来点注释，相对于干巴巴的教程文章，我更喜欢代码中的注释，简洁直给解惑效果更佳。

功夫不负有心人，终于让我找到它们了：

OneFile 汇集了仅一个文件，好玩的开源项目。

项目地址：https://github.com/521xueweihan/OneFile

官网：https://hellogithub.com/onefile/

这里有游戏、编译器、服务器、工具、实用库等，它们运行简单甚至复制代码就能跑。

下面让我们一起来把玩下吧！

1、点击停球

消磨时间的小游戏，只需将球停在有颜色的区域即可得分。所有代码就只有一个 HTML 文件，玩累了还可以右键“显示网页源代码”，研究下源码如何作弊。

试玩：https://hellogithub.com/onefile/code/cc759276aefe4bad87ac259940042581

2、番茄时钟

纯 Python 实现的命令行番茄时钟，另外还支持安装扩展实现桌面通知。复制代码到 PyCharm 右键即可运行。

源码：https://github.com/521xueweihan/OneFile/blob/main/src/python/tomato-clock.py

3、迷你编译器

用 JavaScript 写的迷你编译器，实现将 LISP 转化成 C 代码。每一步写的特别详细注释比代码多，人人都能看懂的编译器项目。打开浏览器的“开发者工具”跳转到“Console”页面，把代码粘贴进去即可运行。

 * LISP C * * 2 + 2 (add 2 2) add(2, 2) * 4 - 2 (subtract 4 2) subtract(4, 2) * 2 + (4 - 2) (add 2 (subtract 4 2)) add(2, subtract(4, 2)) 

源码：https://github.com/521xueweihan/OneFile/blob/main/src/javascript/the-super-tiny-compiler.js

4、字符视频

打开网页授权开启摄像头，你将看到实时转化成 ASCII 码的图像。浏览器右键“显示网页源代码”，即可查看全部源码。

试玩：https://hellogithub.com/onefile/code/126093303b6b414dbab9d623c957fdd4

5、太空侵略者

原版的《太空侵略者》由大约 2k 行的 8080 汇编代码写成，但汇编语言太过底层不方便阅读，今天讲解的开源项目 si78c 是按照原版汇编代码用 C 语言重写了一遍。这个项目虽然核心文件只有一个，但运行稍微复杂，不怕我们有配套讲解文章。

源码：https://github.com/521xueweihan/OneFile/blob/main/src/c/si78c.c

---

万事开头难，但这些项目一点都不难！

无数次想写东西却无从下手...无数个卡住的夜晚...无数次想砸电脑的冲动...

它们都将成为过去式，希望本期推荐的一个文件开源项目，能让你重拾信心发现编程的乐趣。点击发现更多！

开启开源之旅

每个开源项目都是从一个文件开始，通过不停迭代才成为了被人熟知和喜爱的知名项目。

如果你发现某个痛点或者灵光乍现，仅需创建一个文件把它记录下来，然后不断更新迭代并开源出来。最终，它可以帮助到更多人，未来的某一天会惊艳到包括你在内的所有人！

如果让你只用一个文件展示“平生所学”，编程语言不限！你会交出什么样的作品呢？

一个文件的编程挑战，要求如下：

• 单个文件、不可压缩、体积小于 1 MB
• 代码结构清晰，包含注释，行数小于 5000 行
• 不限编程语言，不可仅包含 Markdown 文件
• 不引入任何外部文件（图片、视频、CSS 等）
• 项目功能完整，具有学习或使用价值
• (可选)最多依赖一个开源库或框架

轻点 即可参加，开启你的开源之旅。