jupyter nbconvert --to script 转换失败主因是依赖版本不兼容（如 notebook < 6.5）、路径含空格/中文未加引号、magic命令和交互式语法无法执行；转换仅提取代码单元，不处理逻辑依赖或输出，需人工清理方可运行。
直接用 jupyter nbconvert --to script 就能转，但不是所有情况都“一跑就成”——关键看你的环境有没有装对依赖、文件路径有没有空格、代码单元里有没有交互式语法。
为什么 jupyter nbconvert 有时报错 ModuleNotFoundError？
常见错误是 ModuleNotFoundError: No module named 'notebook.services'，本质是 Jupyter 生态组件版本不兼容。nbconvert 7.x+ 要求 notebook ≥ 6.5 或 jupyter-server ≥ 1.13，而旧版 conda 或 pip 混装容易触发这个报错。
- 先检查版本：
jupyter --version和pip show notebook nbconvert - 若
notebook版本低于 6.5，升级它：pip install --upgrade notebook - 不推荐用
conda update jupyter全量升级——可能把其他包拉垮；优先用 pip 精准更新notebook和nbconvert - 虚拟环境里出问题？先
deactivate再重新source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows），避免 shell 缓存旧路径
jupyter nbconvert --to script 的实际执行要点
命令本身简单，但路径和参数稍不注意就生成失败或文件乱码。
- 必须 cd 进到
.ipynb所在目录再运行命令，不能只写相对路径如../notebooks/demo.ipynb—— nbconvert 对路径解析很脆弱 - 文件名含中文或空格？用双引号包住：
jupyter nbconvert --to script "第5次课.ipynb" - 想指定输出名？加
--output参数：jupyter nbconvert --to script demo.ipynb --output main.py - 默认只转当前目录单个文件；批量转全部？用
jupyter nbconvert --to script *.ipynb（Windows cmd 不支持通配符，得用 PowerShell 或写 for 循环）
转换后 Python 脚本为什么跑不起来？
nbconvert 只提取 cell_type == "code" 的内容，不做逻辑重构——它不是代码翻译器，只是“复制粘贴工”。
- Markdown 单元格全丢弃，注释没了；原来靠单元格顺序隐式依赖的变量，现在可能未定义（比如前面单元格定义了
df，后面单元格才用，转成 .py 后顺序还在，但没加任何保护） -
matplotlib inline、%load_ext autoreload这类 magic 命令会被原样保留，但 Python 解释器不认识，运行时报SyntaxError或NameError - 交互式部件（如
ipywidgets、plotly的FigureWidget）直接失效，对应代码块变成无意义的 import 或空行 - 输出结果（
Out[3]那种）不会被写入 .py，所以别指望转换后的脚本能复现 notebook 里的打印效果
真正要部署，得人工清理 magic、补缺失 import、拆分长脚本、加 if __name__ == '__main__': ——nbconvert 给的是起点，不是终点。
