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

您好，看了您的教程，觉得还是有一些改进空间，我从大到小的范围来说：
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

感谢，已收录在文档里，之后改进