在flask应用开发过程中，调试模式（debug mode）是不可或缺的工具。它能够提供自动代码重载（当文件修改时服务器自动重启）和交互式调试器（在发生错误时提供详细的栈追踪和代码执行环境访问），极大地提高了开发效率。然而，由于其潜在的安全风险，调试模式绝不能在生产环境中启用。
下面将介绍两种在Flask中正确启用调试模式的方法。
方法一：通过环境变量启用调试模式 (推荐用于开发服务器)
这是Flask官方推荐的开发模式启动方式，它利用了Flask CLI工具和环境变量来管理应用。
1. 准备您的Flask应用文件
假设您的Flask应用代码保存在 main.py 文件中，内容如下：
from flask import Flask
app = Flask(__name__)
@app.route("/")
def hello():
return "Hello, World!
"
if __name__ == "__main__":
# 在此方法中，我们不直接调用 app.run()
# 而是依赖环境变量和 flask run 命令
pass2. 配置环境变量
在您的终端（例如Windows PowerShell）中，需要设置两个关键环境变量：FLASK_APP 和 FLASK_DEBUG。
- FLASK_APP：指定您的Flask应用入口文件。
- FLASK_DEBUG：设置为 True 以启用调试模式。
Windows PowerShell 示例：
# 设置 Flask 应用入口文件 $env:FLASK_APP = "main.py" # 启用 Flask 调试模式 $env:FLASK_DEBUG = "True" # 运行 Flask 应用 flask run
Linux/macOS 终端示例：
诚客在线考试是由南宁诚客网络科技有限公司开发的一款手机移动端的答题网站软件，它应用广泛适合各种学校、培训班、教育机构、公司企业、事业单位、各种社会团体、银行证券等用于学生学习刷题、员工内部培训，学员考核、员工对公司制度政策的学习……可使用的题型有：单选题、多选题、判断题支持文字，图片，音频，视频、数学公式。可以设置考试时间，答题时间，考试次数，是否需要补考，是否可以看到自己成绩。练习模式，支持学生
# 设置 Flask 应用入口文件 export FLASK_APP=main.py # 启用 Flask 调试模式 export FLASK_DEBUG=True # 运行 Flask 应用 flask run
解释： 当您使用 flask run 命令时，Flask CLI会读取这些环境变量来配置应用的运行方式。值得注意的是，FLASK_DEBUG 环境变量的值必须是字符串 "True"，而不是数字 1。如果设置为 1，Flask可能不会正确识别并启用调试模式，这通常是初学者遇到的常见问题。
方法二：在代码中直接配置调试模式 (适用于独立运行脚本)
这种方法通过在您的Python代码中直接调用 app.run() 函数并传递 debug=True 参数来启动调试模式。
1. 修改您的Flask应用文件
在您的 main.py 文件中，添加或修改 if __name__ == "__main__": 块，使其包含 app.run(debug=True)。
from flask import Flask
app = Flask(__name__)
@app.route("/")
def hello():
return "Hello, World!
"
if __name__ == "__main__":
# 直接在代码中启用调试模式
app.run(debug=True)2. 运行您的Flask应用
直接使用Python解释器运行您的应用文件：
python main.py
或
python3 main.py
解释： 这种方法绕过了Flask CLI和环境变量的设置，直接通过Python脚本启动服务器。它在某些情况下可能更方便，但缺点是每次切换调试模式状态都需要修改代码。
注意事项
- 生产环境禁用调试模式： 调试模式会暴露详细的错误信息和代码执行环境，这在生产环境中是极大的安全隐患。务必确保在部署到生产环境时禁用调试模式。您可以通过设置 FLASK_DEBUG=False 或移除 debug=True 参数来实现。
- 交互式调试器与PIN码： 当调试模式启用时，如果发生未捕获的异常，Flask会在浏览器中显示一个交互式调试器。为了防止未经授权的访问，Flask会要求输入一个PIN码。这个PIN码通常会在服务器启动时在终端中显示。
- 环境变量的生命周期： 通过 set 或 export 设置的环境变量只在当前终端会话中有效。如果您关闭终端或打开新的终端窗口，需要重新设置这些变量。
-
flask run 与 python main.py 的区别：
- flask run：是Flask CLI的一部分，提供了更多功能，如自动检测 FLASK_APP、配置环境变量等。推荐在开发中使用。
- python main.py：直接运行Python脚本。当您在代码中硬编码 app.run() 参数时，此方法适用。
总结
在Flask应用中启用调试模式是开发工作流的关键部分。您可以选择通过设置 FLASK_APP 和 FLASK_DEBUG=True 环境变量并使用 flask run 命令来启动（推荐方式），或者直接在代码中调用 app.run(debug=True) 并使用 python main.py 运行。无论选择哪种方式，都请牢记调试模式仅限于开发环境使用，以确保您的应用安全。
