“Python 寒假课程第一次作业”这个标题乍看极其普通——没有明确题目没有代码需求甚至看不出难度。但真正在寒假班里带过几轮人之后我反而觉得这份作业是整个寒假课程里最值得认真对待的一次。第一次作业通常不是让你写多复杂的程序而是先完成三件事把 Python 装对、把编辑器配好、最后交一小段能运行且能讲清楚的代码。它的目标不是炫技而是把你拉进一个能持续学下去的节奏里。这篇文章写给马上要交这份作业的同学也写给所有想靠一次作业把 Python 入门的零基础学习者。我会把作业拆开把环境准备、代码实现、报错排查和提交检查这几件事一项一项讲清楚。你照着做大概率能顺利交出第一份零报错的作业而不是被困在安装和报错里消耗掉整个寒假。1. 别急着写代码先把作业拆成三层第一次作业最大的陷阱就是打开编辑器就开始敲代码。我不是开玩笑很多人的第一份作业不是死在语法上而是死在“手里什么都没有直接开始写”这个动作上。你看完题目之后最该做的第一件事其实是拆题。寒假 Python 课的第一份作业普遍不会直接考爬虫、量化策略或数据分析因为课程还没到那一步。老师想确认的其实是三件事你能否让 Python 在你自己电脑上正常跑起来你能否用一个编辑器编写并执行代码你遇到问题时能否定位问题并自己解决。这三项能力合在一起才是“Python 环境配置 基础语法 代码调试”的真正考核范围。所以我会把这份作业拆成三层来做。第一层是环境层安装正确的 Python 版本确认命令行里能调起解释器。第二层是工具层配置 VS Code 或 PyCharm让编辑器能识别同一个 Python 解释器。第三层才是代码层把题目要求翻译成语法和逻辑。这三层加在一起才是完整的“第一次作业交付”。千万不要觉得只要把 .py 文件交上去就完了前面两层没有打通后面会遇到真正意义上的“连锁翻车”。1.1 表面要求往往只有几行但每道题都有隐藏考点拿一份典型的寒假作业通知来看表面要求通常只写几行安装 Python配置开发环境完成指定范围的练习题提交 .py 文件。很多同学只盯着“提交 .py 文件”几个字把大量精力放在代码本身却忽略了通知里其他几个字才是真正的考核重点。第一个隐藏考点是“安装正确”。注意不是“安装了就行”而是版本、路径、PATH 设置全部正确。多同学装 Python 时一路点“Next”最后安装完在命令行输入 python 却提示“不是内部或外部命令”这就是环境层没打通。第二个隐藏考点是“配置编辑器”。老师想看到的不是你用记事本写出来的代码而是你用 IDE 或现代编辑器开发的过程性能力。第三个隐藏考点是“读懂报错”。很多作业会附带几个判断题或问答题比如“SyntaxError 是什么意思”表面在考名词实际上在检查你有没有真正面对过报错。把作业拆成表面要求和隐藏考点之后你才知道哪些地方该花时间。代码写得再好环境配不对同样要被扣分环境配好了但代码逻辑不清晰同样拿不到高分。第一次作业拼的不是智商是耐心和对细节的敏感度。1.2 老师真正想看的是“答题过程”而不只是“答案”你可能会觉得既然是编程作业只要代码跑通、输出正确老师就应该给满分。实际批改的时候老师更看重的是代码体现出来的思维过程。同样是输出一个乘法口诀表有人用两层 for 循环优雅地写出来有人用三行 print 硬生生把完整表格打出来。最后都能跑但老师看到的是完全不同的编程素养。这也是我第一次带学生时反复强调的一点作业里的代码要能体现你是在“编程”不是在“打字”。比如变量命名有没有意义缩进是不是统一函数拆分是否合理边界条件有没有处理。这些都是过程指标。代码跑通只是基本要求能被人快速看懂才是加分项。所以我建议你在代码里加必要的注释哪怕老师没有要求。注释不会直接加分但注释暴露的学习态度和业务理解程度通常会在平时分里体现出来。另外还要注意提交格式。是交 .py 文件还是 Jupyter Notebook要不要同时提交输出截图文件名要不要包含学号姓名这些“隐形规则”占的分值不多但影响老师对你的整体印象。说白了第一次作业是老师认识你的窗口。你交上来一个混乱命名的压缩包里面还有十几个新建文档(1).py老师很难对你有好印象。2. 环境准备装 Python 和配 VS Code最容易踩的就是这三个坑环境准备这步你在教程网站上可能看到的标题是“Python 安装教程”“Python 下载安装教程”“VS Code Python 环境配置”但其实核心就两件事把 Python 装到一个你找得到的位置再让 VS Code 和命令行都连上这个 Python。听起来简单实际操作时我见过太多人卡在莫名其妙的环节。先说安装。我强烈建议不要从 Windows 自带的 Microsoft Store 里搜 Python也不要去百度出来的各种“一键安装包”直接去 python.org 官网下载稳定版。安装界面出现时注意看底下那个 “Add python.exe to PATH” 复选框一定要勾上。这是整个安装过程中最重要的一件事没有之一。勾上之后系统才知道在任意目录输入 python 都该去找谁。很多人装完之后“找不到 python”十有八九是这里漏了勾。安装完成后打开一个新的命令行窗口输入python --version如果能看到类似 Python 3.12.x 的输出说明环境层已经通了。注意一定要开“新的”窗口因为旧窗口不会刷新系统环境变量。这一步做完你的电脑才算真正拥有一个可用的 Python。2.1 Python 安装里那三个反复出事的细节第一个细节是安装路径。默认安装位置很多人不留意但如果你电脑上有多个用户账户或者系统盘权限比较特殊Python 会装到用户目录下的一个隐藏路径里。寒假作业阶段无所谓但后续装包、找文件时会很痛苦。我习惯在自定义安装时把路径改成C:\Python312这种简单目录短期用不到但至少将来不会迷路。当然如果你完全不知道自己在做什么直接接受官方默认路径也没问题别乱点自定义反而更安全。第二个细节是py这个命令。Windows 上安装了 Python 启动器之后有时你输入python没反应但输入py --version能出来。这不是你装错了是系统的执行别名机制在捣乱。Windows 的“应用执行别名”会把python指到 Microsoft Store如果你在设置里没关掉这个别名就会发生“明明装了 Python却识别不到”的奇怪现象。遇到这种情况去“设置-应用-高级应用设置-应用执行别名”里把 python.exe 的开关关掉或者老老实实改用py命令。这个坑特别新因为 Windows 11 上默认容易触发。第三个细节是别同时装两个版本比如 3.11 又装个 3.13。寒假阶段你不需要多版本管理也不需要 conda。多版本只会让 PATH 混乱pip 也不知道装到谁身上。等到你以后真的需要做多版本共存时再考虑 pyenv 或 conda 也不迟第一次作业阶段请保持“一台电脑只有一个主要 Python”的原则。2.2 VS Code Python 环境配置从装扩展到跑通第一行代码编辑器方面VS Code 是最不容易出错的客观选择比 PyCharm 轻也比记事本专业得多。你去网上下载安装 VS Code 之后第一件事是装扩展。打开左侧扩展面板搜索“Python”选择微软官方发布的那个发布者显示 Microsoft下载量千万级那个安装。装完后很多教程会让你安装 Code Runner 之类的辅助扩展我不反对但我建议先别装太多第一次作业阶段一个 Python 官方扩展就够了。第二步是解释器选择。按CtrlShiftP弹出命令面板输入Python: Select Interpreter选择你刚安装的那个 Python。这一步相当于告诉 VS Code以后运行、调试代码时都使用这个解释器。如果你同时装了多个 Python这里选错就会导致“代码里 import matplotlib 失败但明明已经装过”的诡异问题。很多模块报错根子不在“没装包”而在“装包的 Python 和运行的 Python 不是同一个”。第三步是写一段最简单的东西来跑通链路。新建一个文件保存成hello.py写print(hello)点右上角那个三角形运行按钮。窗口下方出现hello说明 VS Code 到 Python 的链路已经打通。以后再学语法、装第三方库都是以这条链路为基础。这里我多说一句如果你只想交作业不在乎后续课程那用哪个编辑器都行如果你寒假课程后面还有项目踏踏实实掌握 VS Code 的这三个操作会让你后面做爬虫可视化、数据分析作业时省下大量时间。2.3 虚拟环境第一次作业到底要不要搞如果第一次作业只是 print 几行、算几个数我建议你不要额外搞虚拟环境。原因很现实虚拟环境会引入“激活”“取消激活”这些概念对零基础的人而言是额外负担容易把耐心耗尽。但是如果你的寒假课程从一开始就安排了一个稍大的项目比如爬虫加可视化、数据处理加图表那你最好学着用虚拟环境。虚拟环境的作用很简单——每个项目都有一套独立的第三方库不会出现 A 项目要 numpy 1.x、B 项目要 numpy 2.x 这种互相打架的问题。操作也简单在项目目录下打开终端执行python -m venv .venv命令行前出现(.venv)就算创建成功。然后在 VS Code 里重新选择解释器选到.venv目录下的那个后面再用pip install装的东西就会进这个项目自己的环境里而不是污染全局。我给学生的建议是第一次作业不用虚拟环境第二次开始用。第一次作业的唯一目标是让你感受“写完能跑”的正反馈不要拿环境复杂度来惩罚自己。3. 从题目到代码第一次作业最常见的三种题型第一次作业的题目翻来覆去不外乎那几种。有的课喜欢出图形打印比如“输出一个爱心”有的课喜欢出基础计算比如绝对值、最大公约数、判断素数也有少数课程会提前布置一点简化的网络或可视化任务。我按题型说一下怎么把它们翻译成代码。3.1 爱心代码 / 图形打印类作业循环和格式化输出的温柔结合“python 爱心代码”这个词在热搜里出现频率很高很多寒假课也喜欢拿它当第一次作业。但你要注意区分如果老师只要求“用基础语法输出一个爱心图形”那重点就是 print、字符串、循环。很多人用二十行代码直接把爱心 ASCII 图像打出来这也能跑但基本没什么编程含量。稍微好一点的做法是用嵌套循环控制每一行的字符数量让它看起来像是生成出来的。更进阶的做法是调用 matplotlib 画一条心形参数曲线适合已经允许第三方库的班级。我分享一个折中版本用 matplotlib 画经典心形曲线代码短、效果直观又比纯 print 有说服力。合适的做法是你先安装 matplotlibpip install matplotlib然后写这样的代码import numpy as np import matplotlib.pyplot as plt t np.linspace(0, 2 * np.pi, 300) x 16 * np.sin(t) ** 3 y 13 * np.cos(t) - 5 * np.cos(2 * t) - 2 * np.cos(3 * t) - np.cos(4 * t) plt.plot(x, y, colorcrimson, linewidth2) plt.axis(equal) plt.axis(off) plt.title(A Heart Shape) plt.show()这段代码为什么适合当范例因为它把“参数方程、数组运算、绘图 API”三个知识点浓缩在一小段代码里。老师看到的是你有能力使用列表操作也理解怎么调用函数同时知道第三方库的基本用法。如果你还不会 NumPy那就先从纯 print 的爱心做起。两种方案都是合法的第一次作业只是展示的学习路径不同。说真的寒假第一次作业能把循环写明白已经比很多人强了。3.2 基础计算与 abs 函数类作业把数学题翻译成计算机指令另一种常见的第一次作业是“输入两个数输出它们差的绝对值”这种基础计算题。这类题目一般想考察的是 input、数据类型转换、以及内置函数比如 abs的使用。很多零基础的同学第一次栽在这里原因是input返回的是字符串不能直接做减法。你需要先用 int 把它转换成整数。一道典型题目可以这么写num1 input(请输入第一个数字) num2 input(请输入第二个数字) a int(num1) b int(num2) diff abs(a - b) print(两数之差的绝对值是, diff)这段代码本身不复杂但它的价值在于体现了完整的“输入-处理-输出”思维。我第一次教学时会专门强调两个细节第一变量名不要用 a、b 草草带过建议用 first_number、second_number 这种能看懂英文的命名第二int()是有风险的操作如果用户输入的不是数字程序会崩。这个风险第一次作业可以不管但你要知道后续学异常处理时多半会拿这个当例子。很多教材会把“abs 函数”单独拿出来讲其实就是想让你积累内置函数的使用经验以后碰到 min、max、sum 时知道去查文档。如果你想把这类作业做得超出预期可以尝试一段多功能的代码输入三个数分别求最大值、最小值、绝对差。这不算超纲因为 min 和 max 也是内置函数只是多走一步。3.3 爬虫或数据可视化作业最小可用方案与被低估的自保建议有些寒假课程比较激进第一次作业就安排“爬虫或数据可视化界面”之类的任务。热搜里“python 爬虫可视化界面”“python 爬虫”的搜索量一直很大但我要泼一盆冷水第一次作业阶段别一上来就啃 scrapy 和复杂框架。先掌握一个最小可用的方案足以应付作业也足够让你建立信心。如果你的作业是爬取一个网页并保存内容最小方案是 requests 加 BeautifulSoup。在终端先安装pip install requests beautifulsoup4然后写这样一段代码import requests from bs4 import BeautifulSoup url https://www.python.org resp requests.get(url) resp.encoding resp.apparent_encoding soup BeautifulSoup(resp.text, html.parser) title soup.title.string print(网页标题, title)这段代码做的是“获取网页标题”。它是爬虫的骨架后面所有爬虫不管多复杂都是从请求到解析再到提取信息。注意用来练习的网络地址最好是官方文档站或你自己的测试页面而且要尊重对方网站的要求。这不是说教是真实建议爬虫代码本身不违法但乱爬有地下内容或登录后端的页面可能会把你的 IP 搞到对方防火墙名单里。寒假作业只需要证明“你会解析页面”不需要证明“你能爬任何网站”。如果作业要求是“数据可视化”最小可用方案是 matplotlib 画柱状图。比如全班成绩分布或几天的气温变化import matplotlib.pyplot as plt days [周一, 周二, 周三, 周四, 周五] temps [12, 14, 13, 18, 20] plt.figure(figsize(6, 4)) plt.bar(days, temps) plt.title(本周每天最高气温) plt.xlabel(日期) plt.ylabel(温度) plt.show()代码逻辑很简单但对第一次作业而言关键是让图表跑出来、窗口能弹出来并且你能在注释里说明每个函数大致负责什么。这比盲目堆代码更能体现你对数据可视化流程的理解。至于“量化交易策略代码”这种热词第一次作业不建议碰。不是说量化多难而是第一次作业写出一个像模像样的策略代码老师很可能会怀疑你是抄的而且你一被问原理就露馅。学习路径稳一点反而走得更快。4. 报错排查与自救指南寒假在家只有你和屏幕写作业的常态是你一个人对着电脑报错信息一屏一屏往外蹦。没有同学可以问老师也不一定随时在线。所以第一次作业里最该练的其实是排查能力看到报错不要慌先读英文先看行号再拆问题。我下面按两类来写一类是环境问题一类是代码问题。4.1 环境类报错“不是内部或外部命令”和 ModuleNotFoundError遇到python 不是内部或外部命令时问题通常出在 PATH。原因就两个安装时没勾“Add to PATH”你可以重新安装勾上再重来或者你安装成功但打开了安装之前就已经存在的命令行窗口所以还没生效。最直接的验证方法是打开一个新窗口输入python --version试一下。实在不行在 Windows 搜索“环境变量”手动把 Python 安装目录加进 Path 变量里。这一步你现在不搞清楚后面用 pip 时会再撞一次。遇到ModuleNotFoundError: No module named requests时不要急着用百度搜“为什么”先做一件事确认你安装包时用的命令和运行代码时用的是不是同一个 Python。最典型的场景是你在 VS Code 右边选了一个解释器在终端里却默认了一个全局环境。解决思路是统一。最简单的方式是在 VS Code 的终端里执行python -m pip install requests用python -m pip而不是直接pip可以保证 pip 跟当前python命令是同一个环境下的 pip。这个词组是我希望所有初学者从第一天就记住的它能帮你避开一半以上的包管理麻烦。还有一类环境问题很隐蔽就是 numpy/pandas 版本冲突。报错信息里一般会出现类似“cannot import name xxx from numpy”的字样。第一次作业阶段我的建议很简单不要自己去踩多版本部署的坑如果发现某个包和另一个包版本冲突就直接把两个包都卸载重装装到最新稳定版。等你有足够经验再考虑深入处理版本依赖。4.2 语法和逻辑报错分清“拼写错误”和“思路错误”语法类报错最常见的是 SyntaxError: invalid syntax。这种报错一出现先看行号再看代码里有没有符合中文引号、逗号全角、括号不配对这类低级问题。关键是你看着屏幕觉得“没什么不对”但解释器就是红字报错那你应该怀疑自己看到的中文标点和英文字符已经混在一起了。中文引号和英文引号在屏幕上长得差不多但解释器只认英文。如果一行代码反复调试不出结果把那个括号、引号删掉重新手输一遍往往就好了。还有一类报错是缩进相关的比如 IndentationError: unexpected indent。Python 用缩进表示代码块如果你在代码里混用了空格和 Tab或者缩进层次不连续就会报错。这也是我特别喜欢让学生统一用 VS Code 的原因它默认会把 Tab 转成 4 个空格从机制上减少这类报错。逻辑错误更麻烦因为程序不报错但输出结果不对。比如想求两数差的绝对值写成 diff a b程序能输出但结果永远错。排查逻辑错误的方法是“人为添加输出”。把每一步计算的结果都 print 出来看哪个变量和你手算的不一致。用惯了之后你会发现print 调试法朴素但真的能解决大多数入门级问题。不要一上来就想用断点调试器第一次作业用不上。4.3 一份新手自查清单和一个可以直接抄的提问模板求助之前先做一遍自查。第一个检查项代码文件保存的扩展名是不是.py不是.txt也不是没有后缀。第二个检查项文件命名有没有包含空格或中文必要时换成hw1_heart.py这种纯英文加数字的名字。第三个检查项终端目录是不是你的项目目录别在别的地方运行 python 然后报“找不到文件”。第四个检查项模块名有没有拼写错误matplotlib不是matplotibrequests不是requets。第五个检查项代码最后有没有写plt.show()很多图形作业卡在没有这一行弹窗。如果自查完还解决不了再去提问。提问时不要只发一张截图把问题描述成三个部分你想做什么、你做了什么、出现什么结果。一个我常用的模板是这样的题目/目标我想用 matplotlib 画一个爱心。 我的操作安装了 matplotlib在 VS Code 里写了代码点了运行。 问题弹出 ModuleNotFoundError报错提示 No module named matplotlib。 我的尝试我重新执行了 pip install matplotlib显示安装成功但还是报同样的错。这种模板最大的好处是让老师一眼看出问题可能出在“运行环境不一致”回复效率比单纯发一句“为什么我的代码报错”高十倍。我在批改作业时最怕看到的提问是“老师我 python 坏了”怎么坏的、在哪一步坏的、报什么错全都没有等于让老师重新做一篇阅读理解。学会把问题描述清楚是编程基本功的一部分甚至比代码水平更能影响别人对你的评价。5. 交作业之前再检查这四件事顺便说点个人经验代码能跑不等于作业能拿高分。每次收作业我都看到有人在“最后一公里”丢分。所以我想把交作业前的四件事写出来你动手之前再过一遍。第一文件命名是否符合要求。老师如果说“学号_姓名.py”你交一个未命名.py印象分直接打折扣。第二文件里有没有注释。有人交上来的代码干干净净一行注释都没有像谜语一样。不必长篇大论但每个稍微难懂的函数或计算块配一行说明就够。第三运行结果有没有验证。点了一次运行成功就提交结果换个环境跑就崩这个问题很常见。建议你保存完文件后重新打开一个终端用python 文件名.py再跑一遍确认运行成功后再提交。第四输出格式是不是符合题目要求。比如题目要求换行、空格、特定文本你却输出了别的格式哪怕计算正确老师也可能会因格式扣分。另外我想跟你分享一个长期有用的习惯把第一次作业的代码整理成一个“个人模板库”。比如输入转换的写法、读取网页标题的写法、画柱状图的写法都保存成小文件。以后做爬虫可视化、数据分析、量化策略你都会反复用其中某几段代码。第一次作业的真正价值不是那一两分而是帮你建立一套“如何从零开始完成一个编程任务”的流程拆题、装环境、写代码、看报错、提问题、交作业。这个流程一旦跑通后面任何 Python 项目对你来说都是同一件事——只是规模更大、库更多而已。最后再补一个我反复测试过的经验第一次作业不要追求“用最少行数”实现功能。简洁当然好但初学阶段更重要的是可读性。把变量名写清楚把逻辑拆成几段甚至在关键位置空一行都比压缩到一行“聪明代码”更能帮助你理解。等到你写过几百小时代码后自然而然会变简洁那是一个顺其自然的过程不是一个急于求成的目标。