显影· 三主题树 · 高中 术语表

Python × Jupyter:边算边写

一格代码一格文字,边算边记——有智能体帮忙,装环境不再是拦路虎。

⏱ 10–15 分钟讲 · 例 · 做 · 卡编号 hs-make-09
学习证据 学完后,怎么核对? 如何核对 · 适用边界 · 最后复核

把学习结果留在一个可以回看、可以复做的动作里;这一区只写学生能自己检查的证据。

如何核对

  • 可复现的数据或创意产物
  • 数据、参数与输出核对

适用边界

用于小规模教学数据与创意原型;结论受数据质量、参数、隐私和运行环境限制。

最后复核

这是内容复核日期,不是学习截止日期。

例子三个小时,卡在门口

阿哲去年立志学 Python:教程第一步「安装环境」——版本挑哪个、装完命令找不到、装包工具满屏红字。三个小时耗在门口,一行代码没写上,他从此认定自己「不适合编程」。今年他把同一件事写成任务单交给编程智能体,卡住就把去标识化后的必要报错贴回去——十分钟后,浏览器里弹出一个能跑代码的笔记本。门槛没有变矮,是有人替你扛了:装环境考的是耐心不是智力,正适合交办(2.1d 的任务单原样够用)。真正值得你自己练的,是进门之后「边算边写」的功夫。

名词两个新朋友:Python=通用编程语言,数据、文件、自动化的主力——JS 住在页面里管交互,Python 住在你电脑里管计算;Jupyter=装着 Python 的「实验记录本」,整页由一个个格子(cell)组成:代码格按一下就运行、结果立刻出现在格子下方,文字格用来写你的想法。

定义边算边写=一格一步的循环

别把 Jupyter 当「能跑代码的文档」,把它当实验记录本用。一轮循环四步:文字格写下这一步想算什么 → 代码格只算这一步 → 先说预测再运行(2.2b 的铁律原样适用)→ 文字格记下发现和下一个问题:

边算边写:一格一步的循环 文字格 · 提问 这一步想算什么? 代码格 · 只算一步 先预测,再运行 文字格 · 记发现 发现+下一个问题 下一轮 · 带着新发现接着问 收尾必做:重启内核 · 从头运行全部——能一口气重跑,笔记本才算数

格子天然就是「小步快跑」:每格一验,错了立刻知道错在哪一格。

一轮长这样。代码格:

# 这学期每天自习几小时?先看平均
hours = [2.0, 1.5, 3.0, 2.5, 0.5, 2.0, 2.5]
avg = sum(hours) / len(hours)
print(round(avg, 2))   # 运行:2.0

看到 2.0,先别急着写下一格代码——开一个文字格,把话记下:

(文字格)平均 2.0 小时,比想象的高。但周五只有 0.5——
波动可能比平均更说明问题。下一格:算每天与平均差多少。
维度一整个大脚本笔记本一格一步
写法全写完才敢跑写一格、验一格
出错红字指向第 80 行,从头排查错的就是刚跑的这一格
留下什么只有结果结果+你当时的想法

泛化换个角度:实验记录本是科学家的老规矩

左手做实验、右手记过程——数据分析同样是一场对话,不是一次宣判:你问一句(代码),数据答一句(结果),你记一笔(文字)再问下一句。笔记本留下的不只是「算出了什么」,还有「当时怎么想的」,两周后重读还能顺着思路走一遍。对话要靠得住还有一条纪律:能从头到尾一口气重跑的笔记本,才是靠得住的笔记本——下面例三会撞见违反它的下场。

核心句:Jupyter 把计算变成实验记录本:文字格写要算什么,代码格一格只算一步,算完就把发现记下来——装环境交给智能体,验证的习惯留给自己。

补充三例——两个常见用法,一个易错。

例一 · 常见用法:装环境的任务单

小晴的交代单四项齐全:背景(Windows 笔记本,从没装过 Python);目标(能在浏览器里打开 Jupyter,跑通第一格 print);约束(只用免费官方渠道,每步先说明再动手);验收(关掉终端重开一次,还能启动)。中途装包工具报了一段红字,她先删掉用户名、完整路径和凭证,只贴必要错误给智能体,两轮修好,前后十五分钟。她把任务单和去标识化报错都存进了 studio——下次换电脑,照单重跑就是。

例二 · 常见用法:算着算着,报告写完了

大鹏把三个月的零花钱流水敲成列表,边算边写:一格算月均,一格找最大单笔,一格算奶茶占比——写第三个文字格时他愣住了:奶茶占了 41%。他把最后一个文字格改成给爸妈的三行说明,整本笔记本顺势就是一份「涨零花钱申请报告」。边算边写最划算的副产品:算完的那一刻,报告的草稿也写完了——每个发现都带着它的证据(上一格的代码和结果)。

例三 · 易错:一格塞十件事,乱序点出假结果

阿凯图快,把教程里三十行代码全贴进一个格子,一跑满屏红字,不知错在哪句;后来他上下乱点格子,上面的格子用着下面格子才建的变量,居然也能出结果——第二天重开笔记本「从头运行全部」,处处报错。错在哪:一格塞了十件事,错了无从定位;乱序运行攒出一堆「隐藏状态」,昨天的结果是点击顺序凑出来的,不是代码本身算出来的。修法:一格一事;每告一段落就「重启内核 → 从头运行全部」,一口气跑通才算数——笔记本要像实验一样可重复。

笔记本昨天明明能出结果,今天打开「从头运行全部」却报错了。最可能的原因是?

安装与数据边界:先确认学校设备、账号年龄要求和安装权限,只用官方渠道;命令先读懂,不为修一个报错就运行陌生的管理员命令。数据用自己的汇总或虚构数字,报错先遮住用户名、路径、密钥。不能安装或联网时,用纸笔/表格按同一套“预测→计算→记录”循环完成。
上机 · 你的第一本笔记本
  1. 把装环境写成任务单交给编程智能体(目标:浏览器里打开 Jupyter 跑通第一格),卡住就贴去标识化后的必要错误。已有环境的同学直接进第 2 步。
  2. 找一组自己的汇总数据或虚构数据(一周自习时长、每天步数都行,七个数就够),不要放姓名、住址、账号或他人信息。
  3. 边算边写至少四轮:每轮=文字格提问 → 代码格算一步 → 文字格记发现。代码不会写可以交给智能体,但每格运行前先说出你预测的结果
  4. 收尾:重启内核 →「从头运行全部」,一口气跑通;git 拍快照,说明写「第一本笔记本」。

怎么算过关:笔记本从头重跑一次全绿;文字格里至少有一条「算之前没想到」的发现;随手指一格,你能说出它只干了哪一件事。

复习卡 · 点一下翻面

边算边写的一轮循环是哪几步?怎么验收一本笔记本靠不靠得住?

答案

文字格写要算什么 → 代码格只算这一步(先预测再运行)→ 看结果 → 文字格记发现、接着问。验收=重启内核、从头运行全部——能一口气跑通才算数。

  • 装环境考耐心不考智力——写成任务单交给智能体,先去标识化再贴必要报错。
  • 一格一事:错了立刻知道错在哪格;乱序点出来的结果是假象。
  • 笔记本比计算器多出来的那半边,是你的思路——文字格别偷懒。