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
twinsant
V2EX  ›  Python

Python 入门教程更新到第 5 课了

  •  
  •   twinsant · 340 天前 · 1301 次点击
    这是一个创建于 340 天前的主题,其中的信息可能已经有所发展或是发生改变。
    2 条回复    2023-04-26 09:54:54 +08:00
    NBXX2018
        1
    NBXX2018  
       339 天前
    您好,看了您的教程,觉得还是有一些改进空间,我从大到小的范围来说:
    1 、知识引入和章节标题的命名:
    我看到 OP 是用另一种面向完全零基础学习者的口吻,然后拆散了传统按部就班的介绍,用各种故事做引子来推进学习。
    那么其实可以用更完整的故事来讲述文档,比如我们从一开始就是在构建一个自己的机器人小管家:第一章“给它安上嘴巴!”,可以继续沿用 OP 用 print 引入函数概念的思路。之后还可以用类似于“让机器人拿到新装备”的故事,引 import 和包管理等云云,把整个机器人小管家的形象,通过我们 python 学习丰满起来,营造一种“阶段性成就感”。
    此外现在章节命名有些混乱,01 、02 是口语化的,而 03 、04 、05 又变成教材语气了,且内容并不包含标题的所有方面内容,不利于后续查阅。
    2 、概念出现顺序冲突:
    003.缩进和循环中,for 循环小节有这么一句“其中 i 是循环遍历 range 返回的 0 、1 、2 ,然后执行代码块里的语句其中 i 是循环遍历 range 返回的 0 、1 、2 ,然后执行代码块里的语句”,那么 i 到底是什么?是一个临时变量,用于存放每次取出来的值。
    但是 OP 没有一开始讲变量这个概念而是放到了 004.条件语句里,而 range 的讲解中无意提到了多个函数传参,这个问题又是在下一章才出现的,新手看到这个案例只能硬啃下去。在后续教程编写的时候,希望可以少一点这些“超前”的知识,虽然对于会的人很基础。
    3 、分段标题和语法糖:
    004 章之后的分段标题趋于混乱,很多非重点内容也单独出了个大标题,如果后续左侧目录做展开显示的话,读者看到分段标题叫“让我们回到老婆让老公买东西的问题”,能猜到这段写的是什么内容吗?标题分段尽可能简洁规范。
    同样是 004 章,介绍到了 f-string 。这个是 3.6 版本之后才引入的一个写法,虽然直观简单但是我觉得不应该直接引入,同时也没有教其他的字符串格式化方法(比如%、format ),不利于后续知识结构化掌握。这里语法糖,后续肯定还会有很多。建议用一个单独的区块包装出来,告诉大家“还有一种更简便的方法”,我觉得更完善学习曲线也更平滑。
    4 、缺失重要概念讲解:
    依旧是 004 章里的问题,if 语句部分的描述是:
    if 条件:
    条件成立的代码块
    else:
    条件不成立的代码块
    这个“条件”的表述不严谨,因为实际判断的不是条件本身而是计算后的布尔值。这样教很容易出现那个经典错误 if Ture = Ture ,把已经是布尔值的变量再代入一边。类似于这样为了利于理解而模糊了程序底层概念的部分,尽可能少出现。


    一些小建议,辛苦 OP 编写的教程。
    twinsant
        2
    twinsant  
    OP
       338 天前
    感谢,已收录在文档里,之后改进
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5253 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 36ms · UTC 09:22 · PVG 17:22 · LAX 02:22 · JFK 05:22
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.