
本文介绍如何在 Flask 应用启动时(仅一次)自动获取并打印/记录 FLASK_APP、FLASK_RUN_HOST 和 FLASK_RUN_PORT 的值,生成类似 “Running my.flask.app on http://127.0.0.1:60210…” 的提示信息,无需手动解析 .flaskenv 文件。
本文介绍如何在 flask 应用启动时(仅一次)自动获取并打印/记录 `flask_app`、`flask_run_host` 和 `flask_run_port` 的值,生成类似 “running my.flask.app on http://127.0.0.1:60210…” 的提示信息,无需手动解析 `.flaskenv` 文件。
Flask 在执行 flask run 命令时,会自动加载 .flaskenv(或 .env)中的环境变量,并将其注入进程环境。因此,我们无需自行解析配置文件,而是直接通过 os.environ 读取已生效的环境变量即可——这是最轻量、最可靠的方式。
以下是在 Flask 应用入口(如 app.py 或 simpleflask/app.py)中推荐的实现方式:
创建 Flask + Vue.js 全栈项目,采用单端口架构、uv 依赖管理、结构化日志和生产级前端设计。当用户要求以下操作时触发:创建新的 Flask+Vue 项目、搭建 Web 应用、构建全栈 Python+Vue 应用、初始化 Flask Web 项目、设置单端口 Flask 前后端项目。触发词:新建项目、创建项目、搭建项目、Flask项目、Vue项目。
import os
from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
return "Hello, Flask!"
if __name__ == '__main__':
# ✅ 在 app.run() 之前读取环境变量(确保只执行一次)
flask_app = os.environ.get('FLASK_APP', 'unknown.app')
host = os.environ.get('FLASK_RUN_HOST', '127.0.0.1')
port = os.environ.get('FLASK_RUN_PORT', '5000')
# 使用 logging 模块更专业(推荐),也可用 print
import logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
logger.info(f"Running {flask_app} on http://{host}:{port} ...")
# 启动服务
app.run(
host=host,
port=int(port),
debug=False # 注意:debug=True 会触发两次启动(重载机制),日志将输出两次
)⚠️ 关键注意事项:
- 该日志逻辑必须放在
app.run()调用之前,且仅在直接运行脚本(python app.py)时生效;若使用flask run命令,则需改用 Flask CLI 自定义命令 或借助@app.before_first_request(不推荐,因不保证“启动时”触发)。 - 若启用
debug=True,Flask 开发服务器会启用重载器(Werkzeug reloader),导致主进程启动两次(父/子进程),从而重复打印日志。生产环境应禁用 debug;开发时如需避免重复,可检查os.environ.get('WERKZEUG_RUN_MAIN') == 'true'(仅主进程为'true'):if os.environ.get('WERKZEUG_RUN_MAIN') == 'true': logger.info(f"Running {flask_app} on http://{host}:{port} ...")
✅ 总结:利用 os.environ 动态读取 Flask 运行时环境变量,简洁、健壮、无额外依赖。配合条件判断与标准日志模块,即可实现清晰、可控、一次性的启动信息输出,大幅提升本地调试与部署可见性。

















