文档首页> Linux命令> 安装Flask web框架hello world

安装Flask web框架hello world

发布时间：2025-09-05 00:02       

Python 安装 Flask 并完成 Hello World（从零到可跑）

下面给出一套可直接复制执行的流程，兼容当前主流 Python/Flask 版本，且包含常见坑位说明与验证方式 ✅

1）准备环境与虚拟环境 🧰

python3 -V                         # 确认 ≥ 3.8
python3 -m venv .venv              # 创建隔离环境
source .venv/bin/activate          # Linux/Mac 激活
# Windows: .\.venv\Scripts\activate
​

解释：用虚拟环境隔离依赖，避免系统 Python 被污染。

2）安装 Flask（升级 pip 后更稳） 🚀

python -m pip install --upgrade pip
pip install "flask>=3"
​

解释：Flask 3.x 需要 Python 3.8+。升级 pip 可减少构建失败概率。

3）编写最小可运行示例 app.py ✍️

from flask import Flask, jsonify

app = Flask(__name__)

@app.get("/")
def index():
    return "Hello, Flask!"

@app.get("/ping")
def ping():
    return jsonify(ok=True)

if __name__ == "__main__":
    # 开发态启用调试器与自动重载
    app.run(debug=True, host="0.0.0.0", port=5000)
​

解释：

  • @app.get("/") 定义 GET 路由；/ping 便于健康检查。
  • debug=True 仅限开发；生产请关闭或换用专业 WSGI 服务器。

4）运行方式（两选一）🧪

方式 A：Flask CLI（推荐）

flask --app app run --debug --host 0.0.0.0 --port 5000
​

解释：--app app 指定模块；--debug 是新方式，取代老的 FLASK_ENV=development。

方式 B：直接 Python 启动

python app.py
​

解释：适合最小示例；复杂项目更建议 CLI 统一管理。

5）访问与验证 🙂

  • 本机浏览器打开：http://127.0.0.1:5000/ 应显示 Hello, Flask!
  • 健康检查：curl http://127.0.0.1:5000/ping 返回 {"ok": true}

6）常见问题与速解（避坑清单）⚠️

现象 可能原因 处理建议
command not found: flask 未激活虚拟环境 先 source .venv/bin/activate再装再跑
端口被占用 已有进程占用 5000 改端口：--port 5001或释放占用
修改代码不生效 未开启调试 用 --debug或 debug=True
Windows 启动被拦 防火墙拦截 允许 Python 访问网络或改用 127.0.0.1
生产部署 直接用内置服务 使用 Gunicorn/Waitress + 反向代理（Nginx），关闭 debug

7）原理速览表（一眼看懂）

动作 命令/代码 作用
隔离依赖 python -m venv .venv 避免全局冲突、便于迁移
安装框架 pip install "flask>=3" 获取最新稳定的 Flask
定义路由 @app.get("/") 将 URL 映射到函数
开发运行 flask --app app run --debug 启动调试服务器，自动重载
健康检查 /ping+jsonify 便于探活与监控

结论：按以上 7 步完成后，你即可在本机稳定跑起 Flask 应用；开发用 --debug，生产换 WSGI 服务器与反向代理，路径清晰、迁移简单。🎯