你是否记得:刚学完编程基础那会儿,特别想写个东西,但动起手来却发现到处碰壁?
你是否找到:一个好玩的开源项目,结果卡在了部署环境、安装依赖上?最后"含恨而终"!
我刚学编程的时候,不止一次打开 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 等)
- 项目功能完整,具有学习或使用价值
- (可选)最多依赖一个开源库或框架
轻点 即可参加,开启你的开源之旅。