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

2023-04-24 09:33:26 +08:00
 twinsant

欢迎提意见:

https://twinsant.gitbook.io/untitled-1/xiu-ding-zhong-005.-luo-ji-tiao-jian

1350 次点击
所在节点    Python
2 条回复
NBXX2018
2023-04-25 15:01:19 +08:00
您好,看了您的教程,觉得还是有一些改进空间,我从大到小的范围来说:
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
2023-04-26 09:54:54 +08:00
感谢,已收录在文档里,之后改进

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

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

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

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

© 2021 V2EX