编程作业卡在报错上，代码改了又改还是跑不通？这篇手册用一个「成绩分析小工具」做练习，带你在 Qoder CN 里从读懂题目开始，按模块修改调试，最后用测试核验结果。重点不是让 AI 替你写完，而是在每一次修改中弄懂代码为什么这样写。
这篇手册能帮你做什么
- 用一份虚拟成绩表，练习「读取 CSV → 校验分数 → 统计 → 绘图」的完整数据处理流程。
- 拿到 3 个可直接复制的提示词，分别用于拆解题目、定位报错和整理测试。
- 学会区分「已经运行验证的结果」和「仍需自己验证的内容」，交出能运行、讲得清的作业。
开始前准备
| 准备项 | 说明 |
|---|---|
| 工具 | Qoder CN 个人版 |
| 项目 | 课程要求、已有的 Python 项目文件夹 |
| 环境信息 | 语言版本、允许使用的库、运行方式，以及课程允许的 AI 辅助范围 |
| 练习数据 | 下面的虚拟成绩 CSV，不需要上传真实同学信息 |
先看效果：同一份数据，整理前后
整理前是一份 6 行的成绩表，其中藏着两个问题：S004 的数学成绩为空，S005 的数学成绩是 108，超出了 0～100 的范围。
整理后得到一份先确认规则、再动手修改的校验计划：
| 原始记录 | 分数原值 | 待核事项 |
|---|---|---|
| S001 | 数学 86／英语 92 | 保留原值 |
| S004 | 数学空／英语 76 | 空值规则待确认 |
| S005 | 数学 108／英语 90 | 越界规则待确认 |
同时列出验收条件：空 CSV、非法字符等用例需在本地运行验证；规则确认后再统计，不补零、不删行、不伪造均值。
练习材料
把下面的内容保存为 scores.csv，放进项目文件夹：
student_id,math,english
S001,86,92
S002,74,81
S003,95,88
S004,,76
S005,108,90
S006,60,65
第 1 步：带着题目读项目
在 Qoder CN 打开项目文件夹，提供题目、技术要求与已有代码。先梳理文件作用、输入输出和实现步骤。
这一步先不改代码，让 Qoder 帮你把题目拆成小步骤，并告诉你每一步需要理解哪些知识点：
我正在学习 [课程名称]，课程允许的 AI 辅助范围是 [使用规则]。
作业要求：[粘贴题目与评分标准]
开发环境：[语言版本、允许使用的库、运行方式]
已有代码：[说明文件位置与已完成的功能]
请先阅读相关项目文件，不要直接修改代码。
1. 用适合初学者的语言解释输入、输出和各文件的作用。
2. 将需求拆成小步骤，列出每一步需要我理解的知识点。
3. 标出需要补充的信息，不要猜测不存在的文件、接口或依赖。
4. 以“读取 CSV—校验分数—统计—绘图”为例，说明各阶段如何验收。
我确认计划后，再逐步协助实现，每次说明修改理由。
第 2 步：按模块修改与调试
每次聚焦一个功能；遇到报错时补充完整错误信息与复现步骤，比较修改前后差异，确认每处变更。
练习时，读到 S004 的空值或 S005 的越界分数时很可能出错。先确定处理规则，再让 Qoder 给出最小修改方案：
请协助排查我的课程项目，不要重写整个项目。
相关文件：[文件路径或代码片段]
运行命令与环境：[命令、语言版本、依赖]
完整报错：[粘贴报错与堆栈]
复现输入：[使用虚拟或已获授权的数据]
预期结果：[我希望发生的行为]
实际结果：[实际观察到的行为]
请先定位问题并解释原因，信息不足时先向我确认。
给出最小修改方案，说明为什么有效、可能影响什么。
针对 scores.csv 中的空值和超出 0～100 的分数，先确认处理规则再修改。
不要删除原始数据、升级依赖或修改无关文件；需要操作时先说明。
最后给出复现与验证步骤，区分“已观察到的结果”和“仍需运行验证的内容”。
第 3 步：用测试检查结果
让 Qoder 辅助整理正常、缺失与异常输入的测试思路，在本地运行并核验结果，再记录实现方法与限制。
请协助检查课程项目，并整理我能理解的测试与运行说明。
项目目标：[题目与验收要求]
相关代码：[文件路径]
运行环境：[语言版本与依赖]
现有测试及结果：[没有则写“暂无”]
请建议覆盖正常输入、空 CSV、缺失分数、非法字符和越界分数的测试。
对每项测试列出输入、预期行为和判断依据；未明确的规则先问我。
给出适合当前项目的测试代码或检查步骤，由我审阅后运行。
运行命令前请说明用途，并按工具提示等待确认。
根据实际结果整理项目说明：环境、运行方法、实现思路、已验证结果与限制。
不要声称未执行的测试已通过，不要编造成绩、截图或性能数据。
你最终会得到
- 一个数据处理脚本；
- 一张成绩统计表和一张分数分布图；
- 一份包含运行方法和测试记录的项目说明。
核验清单
- 空值是否按约定的规则处理；
- 超出 0～100 的分数是否被识别；
- 统计结果是否与手工计算一致；
- 项目说明中的「已验证」是否都在本地实际运行过；
- 每一处修改，自己能否讲清楚原因。
