当前位置：首页 > news >正文

python Flask开发基础教程

news 2026/7/2 5:17:52

下面是一份面向初学者的 Flask 实战开发教程，从「跑起来」到「能上线」，循序渐进，偏实战导向。你可以跟着一步步敲代码。

一、Flask 是什么？适合做什么？

Flask 是一个用 Python 编写的轻量级 Web 框架，被称为“微框架”：

✅ 核心简单、上手快，适合新手
✅ 自由度高，按需添加插件
✅ 常用于：个人博客、后台接口（API）、小型网站、原型验证
❌ 不适合超大型、强约定项目（那种更适合 Django）

一句话：Flask = 路由 + 请求处理 + 模板渲染 + 扩展生态

二、环境准备（重要）

1. 创建并激活虚拟环境（强烈建议）

# 创建虚拟环境 python -m venv venv # 激活（Windows） venv\Scripts\activate # 激活（Mac / Linux） source venv/bin/activate

激活后，终端前面会出现(venv)。

2. 安装 Flask

pip install flask

验证：

python -c "import flask; print(flask.__version__)"

三、第一个 Flask 应用（Hello World）

新建app.py：

from flask import Flask app = Flask(__name__) @app.route("/") def index(): return "Hello, Flask!" if __name__ == "__main__": app.run(debug=True)

运行：

python app.py

浏览器访问：http://127.0.0.1:5000/

✅ 你现在已经有一个 Web 服务了。

四、核心概念拆解

1. 路由（Route）

路由决定「URL → 函数」的映射关系。

@app.route("/about") def about(): return "关于页面"

带参数的路由

@app.route("/user/<username>") def user(username): return f"用户名：{username}" @app.route("/post/<int:post_id>") def post(post_id): return f"文章ID：{post_id}"

常见转换器：

string（默认）
int
float
path

2. HTTP 请求方法（GET / POST）

from flask import request @app.route("/login", methods=["GET", "POST"]) def login(): if request.method == "POST": username = request.form.get("username") return f"登录成功，欢迎 {username}" return ''' <form method="post"> 用户名：<input name="username"> <button type="submit">登录</button> </form> '''

3. 模板渲染（HTML 页面）

Flask 使用Jinja2 模板引擎。

目录结构

project/ ├── app.py └── templates/ └── index.html

app.py

from flask import render_template @app.route("/") def index(): return render_template("index.html", title="首页")

templates/index.html

<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>{{ title }}</title> </head> <body> <h1>{{ title }}</h1> <p>这是我的第一个 Flask 页面</p> </body> </html>

Jinja2 常用语法

{{ 变量 }} {% if 条件 %} ... {% endif %} {% for item in items %} ... {% endfor %}

4. 静态文件（CSS / JS / 图片）

目录结构：

project/ ├── static/ │ ├── css/ │ │ └── style.css │ └── js/ │ └── main.js

HTML 中引用：

<link rel="stylesheet" href="{{ url_for('static', filename='css/style.css') }}"> <script src="{{ url_for('static', filename='js/main.js') }}"></script>

五、JSON API（前后端分离必备）

from flask import jsonify @app.route("/api/users") def api_users(): users = [ {"id": 1, "name": "张三"}, {"id": 2, "name": "李四"} ] return jsonify(users)

访问：http://127.0.0.1:5000/api/users

返回的是标准 JSON。

六、重定向与错误处理

from flask import redirect, url_for, abort @app.route("/redirect") def redirect_demo(): return redirect(url_for("index")) @app.route("/error") def error_demo(): abort(404) @app.errorhandler(404) def page_not_found(e): return "页面不见了（404）", 404

七、项目结构（推荐的中型结构）

flask_project/ ├── app.py # 入口 ├── config.py # 配置 ├── requirements.txt # 依赖 ├── models/ # 数据模型 ├── routes/ # 路由拆分 ├── templates/ # HTML └── static/ # 静态资源

示例：app.py

from flask import Flask from routes.user import user_bp app = Flask(__name__) app.register_blueprint(user_bp) if __name__ == "__main__": app.run(debug=True)

routes/user.py

from flask import Blueprint user_bp = Blueprint("user", __name__, url_prefix="/user") @user_bp.route("/<username>") def profile(username): return f"用户：{username}"

👉Blueprint（蓝图） 是 Flask 拆分大型项目的核心工具。

八、数据库入门（Flask + SQLite）

安装扩展：

pip install flask-sqlalchemy

示例：

from flask import Flask from flask_sqlalchemy import SQLAlchemy app = Flask(__name__) app.config["SQLALCHEMY_DATABASE_URI"] = "sqlite:///data.db" db = SQLAlchemy(app) class User(db.Model): id = db.Column(db.Integer, primary_key=True) username = db.Column(db.String(80), unique=True, nullable=False) with app.app_context(): db.create_all()