CodeWa - 读懂每一行代码！

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

这是一个创建于 3960 天前的主题，其中的信息可能已经有所发展或是发生改变。

CodeWa（ http://codewa.com ）是我2013年的个人任务之一，很幸运能够在2013年年底之前完成，目前自己试跑了一段时间，也算是最简可用版本出炉。

CodeWa的口号是：“读懂每一行代码！”，这个口号其实来自一个比较无奈的现实。这个现实就是，我们身为程序员，用代码混饭吃，但是很多人每天都只在机械地coding，能够主动去读优秀代码的人其实非常之少。就我身边的朋友来说，每天和各种开源软件打着交道，但是对WebServer的运作、HTTP协议的实现、数据库缓存的内部实现等等完全没有概念，而了解这些最方便有效系统的方法，莫过于读源码。

为什么大家不去读源码？而答案也很简单，水平有限，门槛过高，难于坚持。实际上归结到一个字上，就是“难”。那如果我们能够做一些事，让读源码的难度降低下来，是不是会有更多人愿意去读优秀的源码，提高自己的水平呢？我想这个答案是肯定的。

于是有了CodeWa，在CodeWa，每个人都可以对每一行代码添加自己的批注，每一个人也可以看到其他人添加的批注，当你看不懂一段代码时，其他人的批注没准就能够帮你理解。经过时间的沉淀，可能对每一行代码，我们都能积累很多不同角度的优秀批注，帮助新加入的朋友更容易的进行学习。

CodeWa现在还很简陋，但是让他运作起来的核心功能已经有了，现在，就等你加入了。

http://codewa.com

第 1 条附言 · 2014-01-15 23:43:16 +08:00

更新一下近期工作：
firefox无法滚动的问题解决
firefox行号对内容错位问题解决
添加修改昵称功能，避免暴露邮箱地址的隐私
添加helloworld沙盘演练项目，方便大家试用CodeWa
及一系列内部改造

同时完成了个人的Nginx源码阅读计划的一小部分，对Nginx内存池管理部分源码进行了较完整的批注。见：http://v2ex.com/t/97180

CodeWa

代码

源码

158 条回复 • 2015-04-30 18:09:39 +08:00

1 2

❮

❯

ilingbar

2014-01-06 20:37:52 +08:00

加入。。。。

dimpurr

2014-01-06 20:40:26 +08:00 via Android

构思挺好的，就是要让用户有心去贡献批注这点很难啊 …… 没有考虑到这方面的激励机制么

iammutex

2014-01-06 20:43:49 +08:00

@dimpurr
嗯，实话说，能在知名的开源项目的源码库上，留下自己的一点注解，能够帮到其他读源码的人，就我个人而言，这应该就算是一种激励了。希望不是太过理想化：）

xuanjianfeng

2014-01-06 20:45:23 +08:00

创意很好。大家贡献对代码的理解。

dongbeta

2014-01-06 20:46:44 +08:00

版本升级怎么办？

stupil

2014-01-06 20:46:45 +08:00

该相册会员已进行防盗链。

zzNucker

2014-01-06 21:01:16 +08:00

这个想法挺好啊。

bengol

2014-01-06 21:03:38 +08:00

great idea :)

isayme

2014-01-06 21:17:06 +08:00

来个lua？

zenozeng

2014-01-06 21:17:20 +08:00

很有趣

iammutex

2014-01-06 21:20:24 +08:00

@dongbeta 版本升级这个问题是我最早想过的，我觉得，读源码的过程更多的是在学习，从中学到编程的思想和知识就够了，并不一定要跟进每个版本。相信你精通一个版本后应该能够很容易就读懂跟进的内容，CodeWa目前能帮助到这里已经很满足了。

yangff

2014-01-06 21:21:13 +08:00

「际上归结到一个字上，就是“难”。」
拉到吧，其实是“懒”。

PotatoBrother

2014-01-06 21:21:31 +08:00

想法很不错啊，支持ing

iammutex

2014-01-06 21:22:06 +08:00

@isayme lua是我2013年的读码计划之一，可惜没有达成，下一个确实可能是lua。
一个webserver（Nginx），一个存储产品（Redis），一门语言（Lua），都是最优秀的开源项目，好像是一个很好的开始。

lsmgeb89

2014-01-06 21:22:40 +08:00

以前有过相同的想法，试了下，Firefox 怎么页面都滚动不了啊！

iammutex

2014-01-06 21:23:46 +08:00

@ilingbar
@xuanjianfeng
@PotatoBrother
@bengol
@zzNucker

感谢各位，希望能在CodeWa见到大家，能与大家一起参与贡献。

sapjax

2014-01-06 21:24:11 +08:00

想法不错，以前的《django book》也是这种标注的形式，不过是教程，不是源码 http://djangobook.py3k.cn/2.0/chapter03/

iammutex

2014-01-06 21:25:08 +08:00

@lsmgeb89
兼容性问题请原谅，后续会花时间处理，目前还只是一个beta到不能beta的能跑起来的版本而已。
先建议用Chrome吧。

lazygunner

2014-01-06 21:30:05 +08:00

不错用了一下挺方便

jandan

2014-01-06 21:30:39 +08:00

很不错啊试试

hhrmatata

2014-01-06 21:33:28 +08:00 via Android

想法挺好，很纳闷为什么github不开发这种功能。对于github的追赶着来说，确实一个好特性。

iammutex

2014-01-06 21:37:15 +08:00

@hhrmatata
希望通过CodeWa能有更多人有能力读源码，喜欢上读源码，学到更多东西，到github做更大的贡献。

yetone

2014-01-06 21:38:20 +08:00

很不错，支持！

mahone3297

2014-01-06 21:43:08 +08:00

很赞！不过好像每行代码都注释的话，有些地方有感觉有点累赘（可能说的不太准确，应该说是粒度问题）。

Jat001

2014-01-06 21:46:14 +08:00

@hhrmatata github 有这功能，只不过只能在 commit 中评论。

lsj5031

2014-01-06 21:49:05 +08:00

开源吗，一直想知道类似django books 那样的侧边批注怎么实现的，自己想过几个思路都太繁琐了……

iammutex

2014-01-06 21:52:30 +08:00

@mahone3297 是的，粒度问题确实开始感觉别扭。比如我们想注释的可能是一个函数或者一个类或者一个数据结构。但是这里只能在一行。开始我也苦恼过。
但是换一种方式想，我们在代码里加注释，其实也是选择在某两行之间写下若干说明，我这样一想就觉得给每一行加注释变得理所当然了。比如这一行可以是一个表达式，可以是一个函数调用，可以是一个函数定义的开头，可以是一个类定义的开头。

iammutex

2014-01-06 21:56:37 +08:00

@lsj5031 前端的东西看看源码就能看明白了吧。后端的东西貌似也很简单，存一下每一行加的批注就好了。

blueandhack

2014-01-06 22:02:24 +08:00

防盗链是？

ultragtx

2014-01-06 22:04:33 +08:00

不错支持一下

PS. 为什么大家不去读源码？而答案也很简单，水平有限，门槛过高，难于坚持。实际上归结到一个字上，就是“难”

不是"懒"么

iammutex

2014-01-06 22:05:54 +08:00 via iPhone

@blueandhack 额，貌似是又拍的问题，我尽快解决。感谢提醒！

iammutex

2014-01-06 22:07:32 +08:00 via iPhone

@ultragtx
@yangff
好吧，希望能帮懒人勤快起来。

Mcatt

2014-01-06 22:08:16 +08:00

很赞的想法！

Tankpt

2014-01-06 22:12:49 +08:00

必须一个个开始读么？里面的库有哪些呢

hhrmatata

2014-01-06 22:20:43 +08:00

建议提供api,方便开发第三方的编辑器插件。感觉还是用编辑器阅读比较舒服。

MingZhe

2014-01-06 22:21:46 +08:00

已经绑定进来。。。水平有限，还不敢乱写

hhrmatata

2014-01-06 22:22:17 +08:00

怎么样申请增加开源项目？

iammutex

2014-01-06 22:22:45 +08:00

@Tankpt
目前只放开了Nginx和Redis的两份源码，后续上多了会放更多上去。也会考虑让大家自己上传的方式。但目前，确实只有这两个。

allan888

2014-01-06 22:25:59 +08:00

踢偏全部挂了，防盗链

allan888

2014-01-06 22:26:24 +08:00

@allan888 “图片”全挂了，打错

ceclinux

2014-01-06 22:30:05 +08:00

好东西啊，支持~

iammutex

2014-01-06 22:32:04 +08:00

@allan888
@blueandhack
图片被防盗链的同学，能否帮助提供一下ip，感谢。（ http://ip.cn/ ）

timothyye

2014-01-06 22:34:21 +08:00 via Android

不错的创意，就是貌似图床有问题，满页的防盗链

cute

2014-01-06 22:36:10 +08:00

不错的想法。

2exco

2014-01-06 22:43:41 +08:00

有创新，加油！

iammutex

2014-01-06 22:45:24 +08:00

@timothyye
@allan888
@blueandhack
不好意思，是用了又拍的付费图片服务，好像某些地区CDN的图片防盗链规则没有更新，已经联系他们解决。并先将图片放到自己本机先提供服务了。

fdsfsdfsdf3334

2014-01-06 22:47:08 +08:00

为什么没有python方面的另外，注册了个帐户，为什么用户名显示的直接是我的邮箱前缀还有隐私可言吗

iammutex

2014-01-06 23:10:34 +08:00

@fdsfsdfsdf3334
python方面的暂时没有。
昵称这个确实抱歉，直接用了邮箱前缀，是有一定隐私问题。
现在CodeWa还比较简陋，不仅昵称设置功能，很多功能都还没有，会尽快考虑大家的各种需求进行迭代。

PotatoBrother

2014-01-06 23:14:04 +08:00 via iPad

希望加入tornado的源码啊

ChiangDi

2014-01-06 23:14:14 +08:00

好东东～～

cbsw

2014-01-06 23:45:13 +08:00

LZ能把代码开源出来不，你一个人要实现大家提出的要求貌似太困难了吧，比如Firefox的不兼容问题，开源出来相信大家很快会帮助解决的

mahone3297

2014-01-06 23:56:45 +08:00

@iammutex 但是换一种方式想，我们在代码里加注释，其实也是选择在某两行之间写下若干说明，我这样一想就觉得给每一行加注释变得理所当然了。比如这一行可以是一个表达式，可以是一个函数调用，可以是一个函数定义的开头，可以是一个类定义的开头。
嗯，你这样说也有点道理。但是可能展现形式要稍微考虑下。不是每次点一行，出来一个注释。
可能不点，把每行注释直接显示出来，不需要多点一下，可能这样的形式会比较好。
ps：看到你说你好像用的时又拍云。你时付费的吗？还是多少量以内时免费的？

iammutex

2014-01-07 00:02:27 +08:00

@mahone3297
也纠结过不用点就出来的模式，最后放弃的原因是，还是希望能够尽量读，读不明白再点注释看。这样可能能学到更多东西？毕竟我们读的是代码，而不是注释，就像那种英文下面就是中文的文章，很难真的学到英文。当然，这个可以再等实践检验一下：）
又拍是付费的，我当时做 NoSQLFan.COM 时买的～我用量不大，一直都没用完。

iammutex

2014-01-07 00:03:52 +08:00

@fdsfsdfsdf3334
已经添加一个简陋的修改昵称功能，隐私问题确实是大问题。有需要的同学可以点CodeWa导航栏上的“设置”去修改昵称。

iammutex

2014-01-07 00:07:07 +08:00

@cbsw
多谢建议，现在刚有雏形，开源的话，应该是在产品形态基本确定后会考虑的东西。

maddot

2014-01-07 00:15:37 +08:00

有意思，为什么不走国际路线做成英文的呢

shellcodecow

2014-01-07 00:42:48 +08:00

代码考虑开源不？

SR1

2014-01-07 00:47:03 +08:00

很不错的想法，支持楼主～
挑个文字上小错误，见上图

xigua1

2014-01-07 04:05:33 +08:00

牛逼！！很给力

lsj5031

2014-01-07 04:50:37 +08:00

@iammutex
哦……这我想过的，不过觉得粒度不太灵活的……
我是想把这样的形式做进博客里……
但是如果这么弄不管批注是按行走还是按段走都很麻烦……

第一文章要打散之后存储，然后万一修改一下也很有可能伤筋动骨……

bakac

2014-01-07 07:12:45 +08:00 via iPad

ios不能滚动代码

yolio2003

2014-01-07 08:15:37 +08:00

太棒了, lua +1 支持

iammutex

2014-01-07 08:34:22 +08:00

@SR1 fixed，多谢

iammutex

2014-01-07 08:36:41 +08:00

@bakac iPad可能还考虑一下兼容性，iPhone真心还没想到好的信息组织方法，就算样式功能上按PC版兼容了其实也是不可用。想到好的组织方法再考虑动手：）

shizhz

2014-01-07 08:38:43 +08:00

太好了，我给自己2014年的目标就是认真读代码，以前总是抱着书看，最近发现自己的动手能力真的很差，其中没有读过优秀代码也是主要的原因之一。我主要做java开发想从spring开始读，比较低端不知道有没有童鞋有兴趣:(
很希望参与楼主这个计划。

allenforrest

2014-01-07 08:57:39 +08:00

Safari 支持的很好：
1、如果能选择一段代码做 comment 就更好了。
2、如果有一个顶部或侧边的导航，能一眼看到当前代码文件有多少注释点了，并且能快捷移动到每一个注释点，就更好了。

book118

2014-01-07 09:00:23 +08:00

想法不错，要是网站做得好，稳定，就有发展。I think

bakac

2014-01-07 09:03:45 +08:00

@iammutex 有注释的行应该整行与没有注释的不同这样才能让别人更容易知道这里有注释可以看

ygmpkk

2014-01-07 09:04:07 +08:00

这个很好，我以前有这方面的想法，做这样一个东西。强烈支持

linuxer

2014-01-07 09:08:04 +08:00

支持一个，就是Firefox用不了。

iammutex

2014-01-07 09:08:22 +08:00 via iPhone

@allenforrest 谢谢建议
按段做批注不易于查看方式的统一，目前还没有想到好的做法，在代码块开始的位置来写可能更容易让人理解一点
第二点，能告诉我一下你为什么会有这种需求吗？在我看来批注点是一个附属信息，主体还是对源码的阅读。现在在读到有批注的行，行号的颜色会更深一点作为标识，不知道这个是否满足你的需求。

iammutex

2014-01-07 09:11:49 +08:00 via iPhone

@bakac 其实现在就是这样的，有批注的行，行号会加深。不过现在批注还很少，大家可能没看到。
另外，文件列表中，文件名后面的数字就标识此文件有多少批注，可以找个批注多的文件点进去感受一下。

bakac

2014-01-07 09:12:34 +08:00

@iammutex 我一开始找了很久才发现在行号那......