# 解决 `python main.py` 窗口闪退问题（终极指南） ## 题目重述 用户在 CMD 中输入 `python main.py` 后，**黑色窗口瞬间弹出又消失**，无法查看报错信息。 这种情况导致你无法判断程序是否运行成功、为何失败。 --- ## 答案 ✅ **根本原因：程序启动后立即崩溃，错误信息一闪而过。** 你必须**阻止窗口自动关闭**，才能看到真实错误！ --- ## 详解 ### ✅ 1. 为什么窗口会“闪一下就没了”？ 因为你在 Windows 上双击运行 `.py` 文件，或通过某些方式触发了独立进程： - Python 解释器启动 - `main.py` 开始执行 - 遇到错误（如缺少模块、语法错误、路径不对） - 程序崩溃退出 - 控制台自动关闭 👉 你看不到错误，是因为它**来不及显示就结束了**。 --- ### ✅ 2. 正确做法：用命令行保持窗口打开 #### 方法一：使用 `cmd` 并手动运行（推荐） 1. 打开文件夹：`movie-crawler/backend` 2. 在地址栏输入 `cmd` 并回车 → 打开当前目录的命令行 3. 输入： ```bash python main.py ``` 4. 即使出错，窗口也不会关闭，你会看到完整报错！ 🎯 示例可能的错误： ``` ModuleNotFoundError: No module named 'fastapi' ``` → 说明你没安装依赖 ``` FileNotFoundError: No such file or directory: '../data/movies.db' ``` → 说明数据库不存在，需先运行爬虫 --- #### 方法二：在脚本末尾加 `input()` 防止退出 编辑 `backend/main.py`，在最后一行加上： ```python if __name__ == "__main__": uvicorn.run(app, host="127.0.0.1", port=8000) # 防止窗口关闭（调试用） input("按回车键退出...") ``` 这样即使程序出错，也会停在这一行，让你看清日志。 --- ### ✅ 3. 常见闪退原因及解决方案 | 错误类型 | 现象 | 解决方法 | |--------|------|---------| | ❌ 未安装 FastAPI | 报错 `No module named 'fastapi'` | 运行 `pip install fastapi uvicorn[standard]` | | ❌ 数据库路径错误 | 报错 `No such file or directory: '../data/movies.db'` | 先运行 `python -m crawler.core` 生成数据 | | ❌ 文件编码问题 | 报错 `SyntaxError: invalid character in identifier` | 用 UTF-8 编码保存 `.py` 文件 | | ❌ 主函数缺失 | 程序无反应直接退出 | 确保有 `if __name__ == "__main__":` 启动服务 | --- ### ✅ 4. 完整调试流程（手把手） #### 第一步：打开正确路径的 CMD 1. 进入 `movie-crawler/backend` 2. 地址栏输入 `cmd` → 回车 你会看到： ```cmd C:\Users\...\movie-crawler\backend> ``` #### 第二步：运行 Python 文件 输入： ```bash python main.py ``` 📌 观察输出内容！ #### 第三步：根据错误逐一修复 ##### 🔴 如果报错：`No module named 'fastapi'` ```bash pip install fastapi uvicorn[standard] ``` ##### 🔴 如果报错：`No module named 'sqlite3'` → 不太可能，因为它是内置库，说明 Python 安装有问题 ##### 🔴 如果程序打印几行后退出 → 检查是否缺少 `uvicorn.run(...)` 或服务配置错误 --- ### ✅ 5. 补充建议：使用 PowerShell 或 VS Code #### 推荐工具：VS Code（免费） 1. 下载 [Visual Studio Code](https://code.visualstudio.com/) 2. 打开整个 `movie-crawler` 文件夹 3. 右键 `main.py` → “在终端中运行 Python 文件” 4. 输出会一直在下方面板显示，不会闪退 --- ## 知识点 - **命令行调试基本功** 使用 `cmd` 在目标目录运行 `python xxx.py` 是查看真实错误的核心方法。 - **input() 防止程序退出** 在脚本末尾添加 `input()` 可暂停程序，便于阅读错误信息。 - **依赖库安装必要性** `fastapi` 和 `uvicorn` 需手动安装，否则 `import` 失败导致闪退。