该技能用于调试 Jupyter notebook 相关问题,定位出错单元格、诊断环境冲突、修复数据流水线失败,并确保 notebook 可在全新内核上端到端运行。其工作思路包括:执行顺序会影响结果,隐藏状态危险,重启内核并全部运行是最终检验,环境漂移常见,内存管理关键,应按工作流而非单段代码排查。
主要排查对象:内核崩溃(内存错误、段错误、死循环、包版本不兼容);导入错误(选错内核、包未安装、包名拼写错误);内存错误(全量加载数据、循环中累积 DataFrame、巨大中间对象);执行顺序问题(手动逐格可跑但重启后全部运行失败);环境冲突(不同包或 Python 版本、缺失系统依赖)。
使用方式按五个阶段推进:诊断、隔离、修复、验证、文档化。诊断中可检查内核状态并打印 Python 版本与可执行路径,重启内核后全部运行以复现问题,确认失败单元格与执行顺序。隔离时可用二分法定位崩溃单元格,在全新单元格中导入问题包并查看版本与文件路径,或用 pip show 检查包信息。修复时可改用分块读取或 Dask 处理大文件,切换正确内核或在当前环境安装依赖,调整单元格顺序,并用 pip freeze 或 micromamba env export 导出环境。验证需清空输出、重启内核并全部运行,最好在全新虚拟环境中按文档重跑。文档化需提供 requirements.txt 或 environment.yml、顶部设置说明、数据要求、预计运行时间与已知问题。
适用场景:notebook 内核崩溃、导入失败、内存持续增长、结果不可复现、同事机器上无法运行、生产 notebook 需要纪律。限制:不编写新的分析代码、不从零设计 notebook 结构、不调试与 notebook 无关的一般 Python 问题、不优化已能正常工作的代码;遇到无法复现、依赖无法解析、无报错崩溃或需要领域判断时应升级询问。缺少官方资料的部分暂未提供。