python-debug-execution 是一套面向 Python 脚本的调试执行模式,旨在解决脚本失败时错误信息不清晰、难以定位原因的问题。其重点在于两方面:完整暴露错误输出,以及确认脚本运行的工作目录。
用途:当执行可能失败的 Python 脚本时,使用该模式可以让 traceback 和退出状态可见,并帮助诊断因路径假设错误导致的文件操作失败,避免出现不透明的“command failed”提示。
主要能力:
- 完整错误输出执行。运行方式为 python3 script.py 2>&1 ; echo Exit code: $?。其中 2>&1 同时捕获标准输出与标准错误,确保 traceback 可见;echo Exit code: $? 显示真实退出状态,便于判断成功(0)或失败(非零)。
- 脚本内工作目录校验。在文件操作前打印 os.getcwd(),并可选打印 os.listdir('.'),用于确认执行上下文与预期一致,使 FileNotFoundError 等路径问题可立即诊断。
使用方式(完整调试工作流): 第一步,向脚本加入诊断代码:在 main 函数开头打印工作目录、Python 版本与目录列表,例如 print(f"Working directory: {os.getcwd()}")、print(f"Python version: {sys.version}")、print(f"Directory listing: {os.listdir('.')}")。 第二步,以完整错误捕获方式执行:python3 script.py 2>&1 ; echo Exit code: $?。 第三步,分析输出:检查 traceback 消息(代码错误)、退出码(0 为成功,非零为失败)、工作目录确认信息以及缺失文件或目录错误。
常见失败模式对照:FileNotFoundError 多因工作目录错误,可检查 os.getcwd() 输出;ModuleNotFoundError 为依赖缺失,traceback 会显示导入路径;PermissionError 为文件访问问题,traceback 显示文件路径;静默失败(退出码 0 且无输出)通常是逻辑缺陷而非崩溃,可添加 print 语句排查。
适用场景:在自动化或智能体上下文中运行 Python 脚本;调试涉及文件交互的脚本;排查 CI/CD 流水线失败;以及任何脚本输出可能被截断或隐藏的情况。
限制:资料未提供该技能的具体安装方式、依赖要求、平台支持范围或额外配置项,暂未提供;上述内容均为执行与调试模式说明,不涉及收费或效果承诺。