flask应用必须显式启动，否则脚本执行完即退出；python app.py无反应是因为未调用app.run()或flask run，且app.run()须置于if name == "__main__":下以防导入时误触发。
Flask 应用不能直接双击运行，必须通过 flask run 或显式调用 app.run() 启动；否则会报错或静默失败。
为什么 python app.py 有时没反应？
常见错误现象：写完 app = Flask(__name__) 就直接保存运行，终端无输出、浏览器打不开 http://127.0.0.1:5000，甚至没报错。
根本原因：Flask 实例化后只是个对象，不自动监听请求——它不像 Django 的 manage.py runserver 那样带隐式启动逻辑。
- 如果你没写
app.run()，Python 脚本执行完就退出，服务根本没起来 - 如果写了但放在模块顶层（非
if __name__ == "__main__":下），在被导入时也会意外触发，导致开发服务器重复启动或冲突 - 用
flask run命令时，Flask 会自动查找app或application全局变量；找不到就报Could not locate a Flask application
app.run() 和 flask run 怎么选？
两者都能跑起来，但适用场景和行为差异明显，选错容易卡在调试里。
-
app.run()是纯 Python 调用，适合快速验证、单文件脚本、或集成进其他流程（比如测试脚本里临时启服务） -
flask run是 CLI 工具，支持自动重载（--reload）、调试器（--debug）、端口/主机配置（--port 8000），且默认只在开发环境启用重载——生产环境绝不能用 -
app.run(debug=True)会开启调试器，但重载不一定生效（尤其在某些 IDE 或文件系统下），不如flask run --debug可靠 - Windows 上若遇到
Address already in use，大概率是上次app.run()没杀干净进程，得手动查taskkill /f /im python.exe或换端口
最小可运行实例长什么样？
不是“Hello World”就行，要能过本地开发闭环：改代码 → 自动刷新 → 浏览器看到结果。下面这个结构最稳：
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return 'Hello, Flask!'
if __name__ == '__main__':
app.run(debug=True, host='127.0.0.1', port=5000)
注意这几点：
-
host='127.0.0.1'比'localhost'更稳妥，避免 IPv6 解析问题导致启动慢或失败 - 端口别用 80 或 443（需要 root 权限），也别用 3000/8080（常被 Node/前端工具占）
- 如果项目有
FLASK_APP=app.py环境变量，就别写if __name__ == ...——否则flask run会忽略它，又回到没反应的状态 - 函数名
hello不重要，但装饰器里的@app.route('/')路径必须是字符串，写成@app.route('/')（多空格）或@app.route(('/'))（括号错）都会报TypeError
为什么改了代码浏览器没更新？
不是 Flask 问题，是启动方式锁死了重载能力。
- 用
python app.py运行时，即使写了debug=True，重载也可能不工作（尤其在 VS Code 终端或某些 shell 下） - 正确做法：终端先设环境变量
export FLASK_APP=app.py（macOS/Linux）或set FLASK_APP=app.py（Windows），再运行flask run --reload -
--reload默认监听.py和.cfg文件，模板文件（如.html）改了不会触发重启——得加--extra-files templates/index.html - 如果用了 PyCharm，它的“Run”按钮默认走
python app.py，得手动改成flask run模式，否则永远看不到热更新
真正麻烦的不是写错哪一行，而是启动路径选错了——同一份代码，python app.py 和 flask run 的行为边界很模糊，但影响的是整个开发节奏。环境变量、调试开关、重载机制，三者得对齐才稳。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
