很多 Python 自动化脚本，自己用的时候没问题，一交给同事就容易出状况。
比如你写了一个整理附件、合并 Excel、批量改文件名的小脚本。你本机目录固定，文件名也熟，运行一次就出结果。但同事拿到以后，可能把文件放错目录，Excel 少了一列，文件正在被打开，或者参数输错了。脚本一报错，他不会看 traceback，只会觉得“这个工具不好用”。
所以这篇不讲很复杂的测试框架，也不把问题讲成工程化大道理。我们就按一个真实办公脚本来拆：在把脚本交给同事用之前，至少要自己先检查哪几件事，怎么准备样例目录，怎么让脚本出错时说人话，怎么留下一份能复盘的结果。
我建议把检查分成五步：样例目录、参数检查、输入文件检查、试运行输出、异常提示。做到这五步，一个脚本就不只是“我自己能跑”，而是“别人拿去也大概率能跑”。
先定一个最小交付目录
不要只丢一个 py 文件给同事。更稳的做法是给一个小目录，让对方一眼知道文件应该放在哪里、命令应该怎么跑、结果会到哪里。
可以这样设计：
office_script_demo/ README.md run_demo.bat config.json samples/ input/ 2026-07-报销明细.xlsx 2026-07-发票清单.xl
