直接用 app.run() 启动 Flask 在本地开发中不安全、不可靠，易导致端口占用、热重载失效、外部无法访问等问题；应优先使用 flask run 命令并显式配置参数。
直接用 app.run() 启动 Flask 会出问题？
本地开发时直接调 app.run() 看似最简单，但默认行为在多数场景下不安全、不可靠，甚至会卡住调试。它不是生产启动方式，也不是推荐的开发入口——尤其当你改了代码却没自动重载，或者访问 http://localhost:5000 一直连不上时，大概率是参数没设对。
常见错误现象：Address already in use（端口被占）、修改代码后刷新页面没变化、终端无任何日志输出、DEBUG=True 却没看到调试器图标。
-
debug=True必须显式传入，不能靠环境变量自动生效（除非你用flask run） - 默认绑定
127.0.0.1，外部设备（比如手机连同一 WiFi）访问不到，得加host='0.0.0.0' - 多线程/多进程参数（
threaded、processes）只影响 Werkzeug 内置服务器行为，和 Gunicorn/uWSGI 无关
debug=True 和 use_reloader=True 是两回事
很多人以为开了 debug=True 就自动热重载，其实不是。debug=True 主要开启调试器（出错时显示交互式 traceback 页面）、启用详细错误页、允许远程执行（危险！仅限本地）。而代码变更后自动重启，靠的是 use_reloader=True（默认为 True，但一旦你手动传了 debug=False，它可能被连带关掉）。
使用场景：本地写接口、改模板、调路由逻辑时，两个都开；CI 脚本里跑测试或预检时，必须关掉 debug 和 use_reloader，否则会卡住。
- 单独设
debug=True但没设use_reloader=True→ 报错能看，但改完代码要手动 Ctrl+C 再运行 - 设了
use_reloader=False但debug=True→ 调试页面还在，但文件监听停了 - 线上绝对禁止
debug=True，哪怕只是临时加一句 print —— 它会让用户看到你的源码路径、变量值、甚至执行任意 Python 表达式
端口、主机、线程参数怎么配才不踩坑
Werkzeug 默认用单线程处理请求，所以并发稍高就卡死。但别急着开 threaded=True 或 processes=4 —— 这只是让内置服务器“看起来能扛一点”，实际性能远不如专业 WSGI 服务器，且会掩盖线程安全问题（比如全局变量、未加锁的缓存操作）。
参数差异：port 默认 5000，但如果你装了其他服务（如 Jupyter、Vite），很可能被占；host 默认 '127.0.0.1'，意味着只有本机能访问；threaded 默认 False，这点特别容易忽略。
- 想让手机浏览器访问本机 Flask：用
host='0.0.0.0', port=5001，并确认防火墙放行该端口 - 需要同时处理多个请求（比如前端发 3 个 API）：必须加
threaded=True，否则第二个请求会等第一个返回 -
processes值大于 1 时，use_reloader会自动禁用（Werkzeug 不支持多进程 + 重载共存） - Windows 上某些 IDE（如 PyCharm）调试模式下，
use_reloader=True可能引发 fork 错误，此时应关掉重载
为什么官方文档现在不提 app.run()？
因为 Flask 2.0+ 推荐用命令行 flask run 启动，它通过环境变量控制行为（FLASK_ENV=development 已弃用，改用 FLASK_DEBUG=1），自动识别 app.py 或 wsgi.py，还能加载配置文件。而 app.run() 是底层接口，暴露太多细节，容易让人误以为它是标准入口。
兼容性影响：旧项目如果写了 if __name__ == '__main__': app.run(...)，升级到 Flask 2.3+ 后，若同时设置了 FLASK_RUN_DEBUG=1，两个 debug 开关可能冲突，导致重载失效或报错。
- 开发阶段优先用
flask run --debug --host=0.0.0.0 --port=5001 - 非交互式脚本（如 Docker 启动）中仍可用
app.run()，但务必显式关闭debug和use_reloader -
app.run()的参数不会读取app.config，比如你写了app.config['DEBUG'] = True，它也不会自动生效
真正麻烦的从来不是参数记不住，而是忘了它们之间有依赖关系 —— 比如 debug=True 会悄悄打开 use_reloader，但 threaded=True 又可能让某些全局状态在重载后错乱。这些边界情况，不真正在多文件、多路由、带数据库连接的项目里跑一遍，很难意识到。
