pycharm社区版不支持flask服务器模板，需手动配置flask_app环境变量（如flask_app=app.py）并用flask run方式启动；专业版内置模板可自动配置。运行方式、host绑定、热重载及配置缓存是常见问题关键点。
PyCharm 社区版不支持 Flask 服务器 运行配置模板，专业版才内置该功能；但无论哪个版本，都能通过通用 Python 配置 + 环境变量正确启动 Flask，关键在于 FLASK_APP 和启动方式是否匹配。
PyCharm 中怎么设置 FLASK_APP 环境变量
这是最常出错的一环：没设或设错 FLASK_APP，flask run 就会报 Could not locate a Flask application。
-
FLASK_APP必须指向一个可导入的模块或文件路径，比如app.py（当前目录下）、src.main:app（src/main.py中定义的app实例） - 在 PyCharm 的运行配置里，进入 Environment variables 字段，填入
FLASK_APP=app.py（注意等号两边不要空格） - 如果项目结构是
myapp/__init__.py里创建了app，则应设为FLASK_APP=myapp；若用create_app()工厂函数，需写成FLASK_APP=myapp:create_app - PyCharm 专业版在
Flask 服务器模板中会自动把FLASK_APP显示为独立输入框，社区版只能手动填进环境变量栏
运行方式选 python app.py 还是 flask run
二者本质不同，不能混用参数，否则会忽略 debug、host、port 等设置。
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 直接运行
python app.py：走的是脚本内app.run()调用，所有参数（如debug=True、host='0.0.0.0'）必须硬编码在if __name__ == '__main__':块里 - 用
flask run：依赖FLASK_APP和 CLI 参数，支持命令行传参，例如--host=0.0.0.0 --port=8000 --debug，但这些参数必须填在 PyCharm 配置的 Parameters 栏里，不能写在代码里 - 社区版推荐用
flask run方式：Script path 设为flask.exe（通常在虚拟环境Scripts/flask.exe或bin/flask），Parameters 填run --host=0.0.0.0 --port=5000 - 专业版用
Flask 服务器模板时，--debug对应界面里的Debug复选框，--host和--port有独立输入框，更直观
为什么改了代码不自动重载
不是所有启动方式都支持热重载，且重载开关受多层控制。
- 仅当使用
flask run且FLASK_DEBUG=1（或FLASK_ENV=development）时，才会启用 Werkzeug 的 reloader -
python app.py中的app.run(debug=True)也能触发重载，但前提是没禁用 reloader（例如加了use_reloader=False） - PyCharm 默认关闭「热重载」相关钩子，尤其在远程解释器或 Docker 场景下，reloader 可能因文件监听失效而静默退出
- 检查终端输出是否有
* Restarting with stat—— 没这句说明重载根本没启动
局域网访问不到 127.0.0.1:5000？
本地能访问但别人连不上，90% 是 host 绑定错了。
-
flask run默认只绑定127.0.0.1，外部无法访问；必须显式指定--host=0.0.0.0 - Windows 防火墙或杀毒软件可能拦截非 localhost 的端口，临时关闭测试一下
- 如果用
python app.py启动，确保app.run(host='0.0.0.0', port=5000)中 host 写的是'0.0.0.0'，不是'localhost'或'127.0.0.1' - 云服务器或 WSL 环境还需确认安全组/网络配置放行对应端口
真正容易被忽略的是：PyCharm 的运行配置一旦保存，就会缓存环境变量和参数，改完 FLASK_APP 后必须点「Apply」再「Run」，否则旧值还在生效。另外，FLASK_ENV=development 在新版本 Flask 中已弃用，但某些老项目仍依赖它来开启调试模式，建议统一用 FLASK_DEBUG=1。
