学习第三方库的使用除了官方文档和书籍是否还有第三条学习道路？

2020-08-12 14:17:06 +08:00
 Hlianbobo
目前我所知道的系统的获取一个新库使用方法的途径有两个。

一、书籍。

二、官方文档

以上两个问题面临两个困难：

书籍：新库或一些比较冷门的库书籍没有中文版或很少。结果就是没选择或选择很少。而且新出的书很多是水货，实际就是整篇复制粘贴官方文档，挣快钱。导致新手被误导或劝退。

官方文档：对新手不太友好。很多示例代码连注释都没有（有人明白为什么官方示例代码没有或很少有注释？）。个人认为这条路适合熟练后当字典用。不太适合新手使用。不知道我的认识是否正确？

那么除了以上两条路径，还有什么适合新手系统性学习一个新库的有效方法呢？（注：请不要介绍学习英语，或者百度，或者培训班）

那些为新库比如 pyecharts 。写书的人（写出好书的，不是那种复制官方文档的人）。他们是如何学习并掌握一个新库，并将其介绍给大众的呢？
2777 次点击
所在节点    Python
19 条回复
fengjianxinghun
2020-08-12 15:00:51 +08:00
有人明白为什么官方示例代码没有或很少有注释？

因为没人愿意写文档或者注释。

三：看源码
sean10
2020-08-12 15:13:09 +08:00
三 看源码 /源码里的单元测试, 有的单元测试里有应用场景.
roundgis
2020-08-12 15:45:57 +08:00
reading their source codes
Accessing
2020-08-12 16:39:37 +08:00
良好的库应该有文档和单元测试，通过这些内容就能够基本了解如何使用。

如果还是不能理解，可以看代码，自己写测试，可以去 StackOverFlow 等网站提问。

「学习外围资料不多的新库」，可以看做一种技能，有很多的小技能组成，刚开始会很难，在执行这个操作的时候，经常记住使用心得体会，慢慢的就会好。
renmu123
2020-08-12 16:44:48 +08:00
优先看文档，如果没有就开 issue 去问，让作者有空完善一下文档之类的，如果你感兴趣，你也可以提 pr 看源码是一件很累的事
siweipancc
2020-08-12 18:39:38 +08:00
以前我也有这个困惑，后来直接啃源码或者仿造一个了#doge
raaaaaar
2020-08-12 18:50:40 +08:00
文档掌握基本用法，单元测试覆盖面全，各种坑应该都有，更直接的方法是直接读源码，造一个轮子，这也是那些分析源码的文章来源。
copymaster
2020-08-12 19:08:19 +08:00
blog
wobuhuicode
2020-08-12 19:13:52 +08:00
有什么比看源码最简单？
书籍会过时，看了也白看。
看文档是你需要用它时候才看，
如果你要学习它，最简单就是看代码
skyrem
2020-08-12 19:17:39 +08:00
ipython 缓缓打出一个 ？
Hlianbobo
2020-08-12 20:41:35 +08:00
@fengjianxinghun 谢谢回复。以 pyecharts 以为例。echarts 好像是 java 写的。目的仅仅是想在 python 开发中画个图。结果要去读 java 源码。这相当于把小问题搞成了一个大问题。要开始学一门新语言。感觉投入产出比不是很划算。当然，要是源码都掌握了。那以后还可以自己改源码。我本来就想学个汽车驾驶。结果学成了汽车修理。这是一条好路么？

或者我对看源码理解有误？
chihiro2014
2020-08-12 20:45:25 +08:00
三：看源码
四：看视频
TwoDogSon
2020-08-12 21:37:51 +08:00
有人明白为什么官方示例代码没有或很少有注释？

答: 写优秀库的大佬和普通使用者的水平有一定的差距 作者以为你会知道这个用法（可能其他主流库类似的用法 或者大家都用的方式）

程序员都爱享受造轮子的快感 不愿意写一份照顾到所有人的使用说明

感觉出了官方文档 源码 没有什么能真正的比这两个更权威的 第三方视频博客解读者 或许是个引导作用（用一种更啰嗦详尽的方式来阐释清楚） 但他表述的是他从这个库学到的 一定小于等于作者的表述

PS: 可提高读源码能力 英语
Read the F*cking Source Code ---周树人
653513754
2020-08-13 08:47:24 +08:00
@Hlianbobo 汽车驾驶简单，一脚油门的事。调接口用就行了。车出了问题才需要去研究源码看下为什么会出问题
fengjianxinghun
2020-08-13 09:45:54 +08:00
@Hlianbobo 能快速读懂一门全新语言是基本功
laike9m
2020-08-13 10:50:52 +08:00
YouTube 视频，一般用人多的库都会有一些视频。至于 pyecharts 是有微信群的，你直接让作者（ https://github.com/chenjiandongx ）拉你就好
panlatent
2020-08-13 14:54:54 +08:00
一般是博文、文档、代码混着看，文章一般会有一些对比，概念，简单使用方法；用法看文档，实现找代码。

如果非国产的框架，建议用 google 搜。不是说外国的月亮圆，google 的第一页，每点进去一篇都会有点收获
cominghome
2020-08-14 08:52:16 +08:00
上了班以后要用啥插件、库，都是花一两小时筛选，然后直接开干，遇到问题再解决... 花大把时间去学习，成本太高了（虽然一把梭后期解决问题的成本也不低，但是老板可不管你那么多）
neoblackcap
2020-08-30 05:56:29 +08:00
第一条就是看对应项目的源代码，不用再看书了。
第二条就更简单了，连源代码都不用看了，你写一个新的库，实现对应的功能，做得比原来的库更好或者一样就可以了。代码，文档都不用看了，而且你想什么时候更新就什么时候更新

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

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

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

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

© 2021 V2EX