想要维护自己的开源项目,但发现读不下去难以维护

2023-03-13 17:04:02 +08:00
 voidmnwzp

去年 10 月份用 go 写了个 tcp 的推送 server ,现在想要维护下代码,添加一些功能,结果发现比较细节的代码居然看不懂了,可能是注释写的少了或者是当初写的太随意的原因,感觉很难看进去,虽然大致逻辑能把握住,但要想在基础上优化或者增加功能难免要在之前代码实现的细节处进行改动,但我现在实在是看不进去这些代码,在云里雾里的情况下贸然改动可能会导致之前的功能都会出 bug ,目前是很纠结到底是推倒重构还是硬着头皮看下去。。。 附地址:https://github.com/NullpointerW/golwpush

3459 次点击
所在节点    程序员
21 条回复
ufo5260987423
2023-03-14 10:55:28 +08:00
@voidmnwzp #20 感谢回复。
1.go 这个规定很正常啊,但是不能文件夹里面有文件夹,把结构弄的深一点嘛?因为我对 go 不熟悉( 8 年前,那时候我还是本科看过一点点),所以就不再评论了。
2.关于目标。一般我们做开源尽量做人无我有,做一些自己遇到的特殊场景。你给自己设置的目标是一个 state-of-art 的场景。也就是说,场景是常见的(似乎是),但是要求太高,一般需要不断做工作打磨才能完成。所以你玩 3a 当然就任务完成的半吊子。而且,为了完成这种任务,不知道你是否采取了一些奇技淫巧——绝大多数情况下这些奇技淫巧是牺牲可读性的,这也就造成了你的现状:看不懂自己的代码。
3 、“总是涉及到好几个模块”这个涉及到本质问题:目标高但是完成度不高,自己又不太写文档和 commit ,功能耦合也高,性能 state-of-art 难度大。

建议:以后写这种项目,不要急于求成一下吃胖子,要把下层结构单个儿写出来做组合。不要怕上层整合不了,大不了重构嘛。你这又不是什么挣大钱的项目,应该有比 python 扔掉若干个大版本重构还要大的勇气 2333
你要觉得自己的项目是 jvm 那种,那倒是有人给你写注释和文档了 2333

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/923644

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX