代码没有结果时，先判断是报错退出、持续运行，还是输出不符合要求，再缩小数据和程序范围定位。USAAIO第一轮报名截止为2027年1月31日23:59 EST，比赛为2027年2月19日美东12:00—15:00。第一轮代码须用CPU运行，调试不能靠切换GPU解决。
一、别一上来就重写整个模型
“没有结果”至少包含三种不同状态：程序已经停止但出现异常信息，程序仍在执行却迟迟不结束，程序正常结束但文件为空或数值不合理。三者的处理方向不同。先观察运行状态、错误信息和最后一条成功日志，才能确定从哪里开始查。
在平时练习中，先记录失败发生在哪个阶段：读文件、预处理、训练、预测还是导出。记录应包括输入文件名、关键数据形状、报错类型及相关代码行；不要只截一张红色报错末尾的图片，更不要把真实账号或私密数据混进求助材料。
下面是排查入口，并不是每一种现象对应唯一原因。应先用最小改动验证猜想，再继续处理下一层。
| 观察到的现象 | 优先查看 | 可以做的小验证 |
|---|---|---|
| 立刻报错退出 | 异常类型、定位行及上游变量 | 检查该变量的类型或形状 |
| 一直运行没有新输出 | 数据规模、循环和当前阶段 | 减少到少量样本并记录耗时 |
| 训练后出现NaN | 输入是否有限、运算及学习率 | 检查首个出现非有限值的位置 |
| 文件存在但无法通过格式检查 | 列名、行数、顺序和保存路径 | 重新读入文件并对照题目 |
看到异常后，不要用一个包住全部代码的try/except把它静默吞掉。这样虽然不再显示红字，却可能让空结果继续流到后面。诊断阶段应保留具体错误和上下文，知道失败原因后再决定如何处理。
二、从错误信息反推输入条件
Python的SyntaxError通常表示语法没有被正确解析，例如括号、缩进或冒号存在问题；NameError提示引用了尚未定义的名称；TypeError常涉及不支持的类型组合。错误显示的位置是定位入口，真正原因也可能来自前面的赋值或数据读取。
以自编练习为例：三条样本的标签是[0,1,0]，模型给出了四个预测值。此时先修正样本对应关系，不能随手删去最后一个预测“让长度一致”。训练集、验证集或索引拼接错误，都可能造成相同表象；必须确认每一条预测属于哪个样本。
如果矩阵乘法形状不合，先写出每个维度的含义。批量大小、特征数和类别数扮演不同角色。仅凭“转置后能运行”不能证明修复正确，应再用两三条可以手算的数据核对输出。把形状写进注释，也比事后反复猜测更省时间。
自编排错入口：先区分报错、持续运行和输出异常
排错顺序可以遵循“最早失败点”：若读取阶段已把数值列读成字符串，就应先处理数据类型，而不是到模型输出异常后再调整网络结构。沿数据流逐层检查，能减少无效改动。
三、程序卡住时，先降低验证成本
练习中可先用少量样本、较少训练轮数和较小模型检查流程，观察是否能从读取走到输出。小样本运行只证明流程基本可执行，不代表模型效果合格；恢复正式数据后，还要检查耗时、内存和预测质量。
如果循环迟迟不结束，检查循环变量是否确实更新、退出条件是否可达，是否在每轮重复读取大文件或进行不必要的数据复制。若是训练耗时长，应先区分“仍在正常计算”与“已经阻塞”，通过阶段日志和样本规模比较判断，而不是每隔几秒就中断重跑。
USAAIO当前第一轮编程部分要求在Google Colab中编写、运行代码并生成文件，通过比赛平台查看任务和提交。第一轮不允许GPU，因此平时就应在CPU条件下估算运行成本。本文的缩小样本、重跑与插入日志均为练习方法；正式作答时须遵守当前部分的操作规则。
四、有输出之后，还要确认结果可用
若预测全是同一类别，可能涉及数据不平衡、标签映射、训练不足或逻辑错误，不能单凭这一现象就诊断过拟合。先检查一小批原始输入、标签和预测是否逐行对应，再看模型与评价指标。程序运行成功与任务完成，是两道检查。
若结果出现NaN或无穷大，应向前追踪第一次产生非有限数值的位置。例如分母为零、对不合适输入取对数、输入本身缺失或训练数值不稳定，都值得检查。不要把所有NaN自动替换成零后直接提交，这可能掩盖严重问题。
文件导出后，要重新读入核对：列名是否符合要求、行数是否等于待预测样本数、顺序是否被排序操作改变、是否多保存了无用索引。输出格式依具体任务确定，不要把练习时的某个文件名或列名当作所有题目的统一标准。
五、建立一次只改一处的调试习惯
每次修改前留下一条可验证的判断，例如“怀疑路径错误，所以先确认目标目录与文件名”，或“怀疑数据量导致耗时，所以对比小样本运行时间”。验证成功后记录结果，验证失败则回退假设，不要同时修改标签、学习率和网络后再猜哪个生效。
平时完成修复后，从清晰的初始状态顺序运行自己的练习文件，确认没有依赖旧变量或残留输出。再把最终结果重新读入，核对关键数量与格式。这样积累下来的排错记录，才是下次遇到相似问题时能直接使用的工具。
比赛规则同样需要准备：每轮须到学生所在学校或USAAIO授权考点现场参加并由真人监考；第一轮非编程部分启用应用锁定，不能切到其他应用、网站或关闭重开。环境故障应向监考人员报告，不能自行关闭监控或绕过锁定。把这些边界与技术练习一起熟悉，才能把调试能力用在允许的范围内。
🔥 AI 奥赛体验课，限时 9.9 元 （原价649元）
翰林名师亲授，一课打通 AI 四大领域，零基础也能学，扫码即可报名咨询 ⇓
USAAIO竞赛新赛季备赛已开启，扫码领取USAAIO真题&参考书
欢迎咨询【USAAIO竞赛辅导课程】
