V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
推荐学习书目
Learn Python the Hard Way
Python Sites
PyPI - Python Package Index
http://diveintopython.org/toc/index.html
Pocoo
值得关注的项目
PyPy
Celery
Jinja2
Read the Docs
gevent
pyenv
virtualenv
Stackless Python
Beautiful Soup
结巴中文分词
Green Unicorn
Sentry
Shovel
Pyflakes
pytest
Python 编程
pep8 Checker
Styles
PEP 8
Google Python Style Guide
Code Style from The Hitchhiker's Guide
Hlianbobo
V2EX  ›  Python

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

  •  
  •   Hlianbobo · 2020-08-12 14:17:06 +08:00 · 2778 次点击
    这是一个创建于 1569 天前的主题,其中的信息可能已经有所发展或是发生改变。
    目前我所知道的系统的获取一个新库使用方法的途径有两个。

    一、书籍。

    二、官方文档

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

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

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

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

    那些为新库比如 pyecharts 。写书的人(写出好书的,不是那种复制官方文档的人)。他们是如何学习并掌握一个新库,并将其介绍给大众的呢?
    19 条回复    2020-08-30 05:56:29 +08:00
    fengjianxinghun
        1
    fengjianxinghun  
       2020-08-12 15:00:51 +08:00
    有人明白为什么官方示例代码没有或很少有注释?

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

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

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

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

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

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

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

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

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

    如果非国产的框架,建议用 google 搜。不是说外国的月亮圆,google 的第一页,每点进去一篇都会有点收获
    cominghome
        18
    cominghome  
       2020-08-14 08:52:16 +08:00
    上了班以后要用啥插件、库,都是花一两小时筛选,然后直接开干,遇到问题再解决... 花大把时间去学习,成本太高了(虽然一把梭后期解决问题的成本也不低,但是老板可不管你那么多)
    neoblackcap
        19
    neoblackcap  
       2020-08-30 05:56:29 +08:00
    第一条就是看对应项目的源代码,不用再看书了。
    第二条就更简单了,连源代码都不用看了,你写一个新的库,实现对应的功能,做得比原来的库更好或者一样就可以了。代码,文档都不用看了,而且你想什么时候更新就什么时候更新
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   5036 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 29ms · UTC 03:53 · PVG 11:53 · LAX 19:53 · JFK 22:53
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.