### 如何在 PyCharm 中启动 Debug 模式 要在 PyCharm 中成功启动 Flask 应用的 Debug 模式，可以按照以下方式配置环境变量和运行参数。以下是详细说明： #### 1. 配置 Flask 环境变量 确保正确设置了 Flask 的环境变量以激活调试模式。可以通过 `.flaskenv` 文件或直接在 PyCharm 中设置环境变量来实现。 - **方法一：创建 `.flaskenv` 文件** 在 `app.py` 所在的同级目录下创建一个名为 `.flaskenv` 的文件，并写入以下内容： ```plaintext FLASK_APP=app.py FLASK_ENV=development FLASK_DEBUG=1 ``` 安装 `python-dotenv` 包以支持读取 `.flaskenv` 文件中的变量： ```bash pip install python-dotenv ``` - **方法二：在 PyCharm 中设置环境变量** 打开 PyCharm 的运行配置（Run/Debug Configurations），找到 Flask 应用的配置项，添加以下环境变量： - `FLASK_APP=app.py` - `FLASK_ENV=development` - `FLASK_DEBUG=1` #### 2. 修改代码中的 Debug 参数 确保在代码中显式地启用了 Debug 模式。例如，在 `app.py` 文件中添加以下代码： ```python if __name__ == "__main__": app.run(debug=True) ``` 这一步是必要的，因为只有当脚本作为主模块运行时，`__name__ == "__main__"` 条件才会为真[^1]。 #### 3. 使用 PyCharm 的 Debug 工具 PyCharm 提供了内置的调试工具，可以直接通过以下步骤启动调试模式： - 右键点击需要调试的 Python 文件（如 `app.py`）。 - 选择 **Debug 'app'** 而不是普通的 **Run 'app'**。 - 在调试模式下，PyCharm 会自动挂载断点并捕获异常，方便进行问题排查。 #### 4. 检查控制台输出 如果一切配置正确，控制台输出应显示 Debug 模式已开启。例如： ```plaintext * Running on http://127.0.0.1:5000/ * Debug mode: on ``` 如果没有看到上述提示，请检查是否遗漏了某些配置步骤[^2]。 --- ### 注意事项 - 如果使用的是 PyCharm 社区版，则可能不支持某些高级调试功能。建议升级到专业版以获得完整支持。 - 确保 Flask 和相关依赖包的版本与教程一致，避免因版本差异导致的问题。 --- ### 示例代码 以下是一个完整的 Flask 应用示例，包含 Debug 模式的启用： ```python from flask import Flask app = Flask(__name__) @app.route('/') def home(): return "Hello, Flask!" if __name__ == "__main__": app.run(debug=True) ``` ---