PPT Master 在 Windows 上报 Python was not found 怎么排查【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master在 Windows 上装好 PPT Master 并准备跑第一份 PPT 之前安装指南的第一步验证就是打开 PowerShell 运行python --version。正常应看到Python 3.12.x之类的输出如果看到Python was not found提示或者命令直接弹出了 Microsoft Store说明后面所有依赖安装和生成步骤都会卡住。项目文档 Windows 安装指南 把这个报错的原因明确写成Python 没有加入系统 PATH并给出了三种修复方式。本文按文档顺序走一遍排查与验证路径。先确认前提是 PATH 问题还是根本没装现象判定PowerShell 中python --version报Python was not found或弹出 Microsoft Store文档给出的原因就是Python 不在系统 PATH 中。前提核对你是否已经从 python.org 安装了Python 3.10这是 PPT Master 在 Windows 上唯一的硬性要求Anaconda / Miniconda 装的 Python 也可以只要python --version显示 3.10 即可。如果完全没装 Python先安装并且安装时务必勾选Add python.exe to PATH——文档把没勾这个选项列为 Windows 上最常见的安装失误不勾的话后面每一步都会出问题。如果已经装了、只是没勾 PATH按下面三种方法修复。方法 1通过安装程序补勾 PATH重新运行 Python 安装程序选择Modify确保勾选Add Python to environment variables然后完成修改。方法 2手动把 Python 目录加入 PATH先在 PowerShell 中运行where python记下它输出的实际路径。文档示例C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\python.exe这是文档示例路径你的用户名要替换成你机器上真实的 Windows 用户名。在开始菜单搜索「环境变量」Environment Variables。找到Path→编辑→ 新增上面路径的目录部分及其Scripts子目录例如文档示例C:\Users\你的用户名\AppData\Local\Programs\Python\Python312 C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts点击确定然后重启 PowerShell——PATH 变更只有在新窗口里生效。方法 3改用 python3 或 py文档给出的第三种尝试是直接改用python3或py命令替代python。相关现象python3命令报 exit 49 或弹 Microsoft Store同一排查章节里还单独说明了这个现象python.org 的安装包只提供python.exe并不带python3.exe。所以如果失败的是python3命令exit 49 / 弹 Microsoft Store文档的处理是把命令里的python3换成python在实际生成流程中AI agent 通常也会自己改用python继续。修复后如何验证在新的 PowerShell 窗口里重新运行python --version看到Python 3.12.x之类的版本输出说明 PATH 问题已解决。接着继续安装流程做完整验证cd C:\Users\你的用户名\ppt-master # ← 替换为你的实际路径 pip install -r requirements.txt如果pip无法识别文档给出的替代命令是python -m pip install -r requirements.txt。安装完成时应看到Successfully installed ...。最后跑核心依赖检查python -c import pptx; import fitz; print(All core dependencies OK)输出All core dependencies OK即说明核心环境没有问题可以继续安装指南的下一步——在支持 Agent 的 AI 工具中打开ppt-master目录生成一个 3 页的「Hello World」测试 PPT确认exports/下出现可编辑的原生.pptx。还没解决时依赖安装阶段如果报的是其他错误pip权限错误、网络问题、ModuleNotFoundError、import fitz失败、PowerShell 提示脚本运行被禁用等属于同一常见问题章节下的独立条目按各自方法处理。仍无法解决时文档要求在求助时附上Python 版本、Windows 版本和完整报错信息可先查阅FAQ。【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考