机器人课程维护记录：模块找不到时先分清运行环境

机器人课程示例出现模块找不到的提示时，教师常会先想到补装依赖。但维护记录的第一步应是弄清谁在什么环境中运行了哪份示例，以及错误文字实际指向什么。本文讨论假设的课程软件故障，不安装任何软件包，不修改系统环境，也不连接机器人执行课程程序。

保存报错位置，而不是只记一句无法运行

初始记录可以包含课程资料版本、示例入口和实际报错文字。若提示来自学员截图，应说明截图来源，并去掉个人目录或身份信息等无关内容。没有取得完整提示时，先列为待补，不根据课程名称猜测缺少哪一个模块。

假设同一讲义在教师机器上可以演示，学员提交的截图却显示导入失败。两项观察应并排保留，不能让教师环境的结果覆盖学员环境的问题。维护人员需要确认两边是否真在使用同一份课程材料，以及记录的是同一种运行方式，再决定后续调查范围。

Python虚拟环境文档说明，虚拟环境默认与其他环境及系统安装的软件库隔离，并讨论了通过对应解释器运行的方式。这提示维护记录应识别实际运行环境，而不能仅凭电脑上曾经装过某个库，就断言当前示例一定能够导入它。

责任方可以按获准流程记录实际解释器和环境关联，并与课程要求对照。本文不提供会改变现有环境的命令，也不要求学员把全部软件清单或私人路径公开。若缺少运行环境信息，应如实写未知，由负责人员补充，而不是用教师机器上的配置代替。

PyPA对发行包与导入包的说明明确，两类名称之间没有强制的一一对应关系，不能看到导入语句中的名字就盲目安装同名发行包。维护时应请课程提供方说明它依赖的正式项目及来源，而不是让接收人员按名称猜测。

在假设故障里，报错中的导入名可以作为定位线索，但仍需要关联课程的依赖说明。若两份资料写法不同，应保留原文并向供方确认。为了让报错尽快消失而安装来源不明的同名内容，可能改变调查对象，也让后续人员难以判断环境里究竟增加了什么。

本次文章不执行任何安装或导入检查。可读的维护记录应把“已确认课程要求”“当前环境实际观察”和“准备询问供方”分开，这样下一位教师能够继续处理缺口，而不必从一串未经核对的软件名称重新开始。

若责任方决定在获准的教学环境里重新演示，应明确所用课程版本、环境和任务，并保留真实结果。不要因为一份配置说明已补齐，就把示例运行状态写成通过。资料修正解决的是解释问题，实际演示是否成功需要相应观察。

如果供方回复指出原示例需要另一份适用说明，应把该回复与最初报错关联起来。不要删除原来的讲义和问题记录后，只留下一个新环境的成功截图。前后材料的关系保留清楚，课程维护人员才能判断修订影响了哪些练习，而不是误以为所有课程都已复查。

维护交接应说明原先哪一步受阻、运行环境是否已明确、导入名称与课程依赖关系是否得到答复，以及复查是否实际进行。若仍有未知项，继续保留。本文没有真实学员数据和运行结果，更没有把软件资料排查当作机器人实操或学习效果评价。

两图均为原创课程维护示意，不是实际错误截图或软件安装流程。相关材料可见机器人培训栏目及文章目录。把环境、名称和观察分别说明，能让维护人员少一些基于名字的猜测，多一些可对应的资料。