一个文件,这个开源项目有点东西!
你是否记得刚学完编程基础那会儿,特别想写个东西,但动起手来却发现到处碰壁?
你是否找到一个好玩的开源项目,结果卡在了部署环境、安装依赖上?最后”含恨而终”!
我刚学编程的时候,不止一次打开 IDE 看着闪动的光标发呆,大脑和空白的页面一样,一片空白毫无头绪。想写点东西根本无从下手,想玩别人的项目也跑不起来。一下子从书本抄代码的阶段,转变到自己构思、设计、编写代码,这跨度着实有些大。当时感觉自己学的那些什么语法规则,都吃完拉了什么都没留下。

有没有人和我一样,有过上面的经历或者正处于这种状态。那么有没有那种比书上的实例代码长一些,有些实际用途的开源项目。即:
一个文件、运行简单、一看就懂、有趣的开源项目!
因为一个文件的项目基本上复制代码到编辑器里就能跑,还可以通过调试看每步的结果更容易读懂代码。重点是它要有实际用途,不是代码例子,这样就可以拿出去给别人看和使用,学起来很有动力。代码中再多来点注释,相对于干巴巴的教程文章,代码中的注释简洁直接,解惑效果更佳。
功夫不负有心人,终于让我找到它们了:
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
万事开头难,但这些项目一点都不难!
无数次想写东西却无从下手…无数个卡住的夜晚…无数次想砸电脑的冲动…
它们都将成为过去式,希望本期推荐的 一个文件 开源项目,能让你重拾信心发现编程的乐趣。
开启开源之旅
每个开源项目都是从一个文件开始,通过不停迭代才成为了被人熟知和喜爱的知名项目。
如果你发现某个痛点或者灵光乍现,仅需创建一个文件把它记录下来,然后不断更新迭代并开源出来。最终,它可以帮助到更多人,未来的某一天会惊艳到包括你在内的所有人!

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