Python Flask 框架快速入门与核心应用 | 极客日志

Python

Python Flask 框架快速入门与核心应用

本文详细介绍了 Python Flask 框架的快速入门与核心应用。内容涵盖项目初始化、路由规则（含参数与正则）、响应处理（HTML/JSON/重定向）、Jinja2 模板引擎的使用、请求数据获取、会话控制（Cookie 与 Session）以及基于 SQLAlchemy 的 ORM 数据库操作。此外，文章还补充了数据库迁移工具的使用方法及安全与最佳实践建议，适合希望快速掌握 Flask Web 开发的开发者参考。

GRACE Grace发布于 2025/2/6更新于 2026/4/202 浏览

Flask 是 Python 的一个轻量级 Web 框架，因其灵活性和易用性而广受欢迎。本文将详细介绍 Flask 的基础配置、路由规则、模板引擎、请求处理、会话控制以及 ORM 数据库操作等核心功能。

一、项目初始化

使用 PyCharm 自动创建项目或手动创建均可。推荐的标准目录结构如下：

├── app.py
├── config.py
├── exts.py
├── models.py
├── /
└── templates/

from flask import Flask

app = Flask(__name__)
 
@app.route('/')
def hello_world():
    return "hello world"

if __name__ == '__main__':
    app.run()

参数	说明
`static_path`	静态文件访问路径（不推荐使用，建议使用 `static_url_path`）
`static_url_path`	指定静态文件的访问路径（默认为 `/static`）
`static_folder`	存放静态文件资源的文件夹名称（默认为 `static`）
`template_folder`	存放模板的文件夹名称（默认为 `templates`）

@app.route('/')
def hello_world():
    return "hello world"

@app.route("/user/<username>")
def user_info(username):
    return "hello %s" % username

@app.route("/user/<string:username>")
def user_info(username):
    return "hello %s" % username

from flask import Flask, render_template
from werkzeug.routing import BaseConverter

app = Flask(__name__)

class RegexConverter(BaseConverter):
    def __init__(self, url_map, *args):
        super(RegexConverter, self).__init__(url_map)
        self.regex = args[0]

app.url_map.converters['re'] = RegexConverter

@app.route("/user/<re('lcz.{2}'):username>")
def user_info(username):
    return "hello %s" % username

@app.route('/')
def index():
    return render_template("index.html")

if __name__ == '__main__':
    app.run()

from flask import request

@app.route("/user", methods=["GET", "POST"])
def user():
    if request.method == "GET":
        return "user get"
    elif request.method == "POST":
        return "user post"
    else:
        return "method not allowed"

@app.route("/user")
def user():
    return "<h1>User Info</h1>"

from flask import render_template

@app.route('/')
def hello_world():
    return render_template("index.html")

from flask import jsonify

@app.route("/user")
def user():
    data = {
        "user_name": "lczmx",
        "age": 18
    }
    return jsonify(data)

from flask import redirect, url_for

@app.route("/index")
def index():
    return redirect("/")

from flask import redirect, url_for

@app.route("/user/<int:user_id>")
def user(user_id):
    if user_id > 200:
        return redirect(url_for("vip_user", user_id=user_id))
    else:
        return redirect(url_for("general_user"))

@app.route("/vip_user/<int:user_id>")
def vip_user(user_id):
    return "vip_user %s" % user_id

@app.route("/general_user")
def general_user():
    return "general_user"

@app.route('/')
def index():
    return render_template("index.html"), 200

@app.route('/')
def index():
    return render_template("index.html", name="嘻嘻嘻")

def add_suffix(line):
    return line + "--嘻嘻嘻"

app.add_template_filter(add_suffix, 'add_suffix')

@app.template_filter()
def add_suffix(line):
    return line + "--嘻嘻嘻"

{% if user_info.nid == 10 %}
    <li>{{ user_info.msg1 }}</li>
{% elif user_info.nid == 20 %}
    <li>{{ user_info.msg2 }}</li>
{% else %}
    <li>{{ user_info.msg3 }}</li>
{% endif %}

{% for name in name_list %}
    <li>{{ name }}</li>
{% endfor %}

属性	说明
`index0`	当前迭代的索引 (从 0 开始)
`index`	当前迭代的索引 (从 1 开始)
`first`	是否为第一次迭代
`last`	是否为最后一次迭代
`length`	数据长度

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
{% block title %}{% endblock %}
<div>
    <h1>今天是个好日子</h1>
</div>
{% block content %}
    <h3>我是内容</h3>
{% endblock %}
{% block js %}
<script src="../static/js/jquery.js"></script>
{% endblock %}
</body>
</html>

{% extends "base.html" %}
{% block title %}
    <h1>啦啦啦</h1>
{% endblock %}
{% block js %}
{% endblock %}

属性名	说明
`request.scheme`	获取请求协议
`request.method`	获取请求方式 (GET / POST)
`request.args`	获取 GET 请求提交的数据
`request.form`	获取 POST 请求提交的数据
`request.cookies`	获取 Cookie 信息
`request.headers`	获取请求头信息
`request.files`	获取上传的文件
`request.path`	获取资源路径 (不带参数)
`request.full_path`	获取完整路径 (带参数)
`request.url`	获取完整地址

from flask import make_response

@app.route('/set_cookie')
def set_cookie():
    res = make_response('set cookie page')
    res.set_cookie('username', 'lczmx', max_age=604800)
    return res

from flask import request

@app.route('/vip')
def resp_cookie():
    user_name = request.cookies.get('username')
    if user_name == "lczmx":
        return "vip"
    else:
        return "bye"

import os
print(os.urandom(24))

CSRF_ENABLED = True
SECRET_KEY = '你的随机密钥'

import config
app.config.from_object(config)

from flask import session

@app.route('/set_session')
def set_session():
    session['username'] = 'xxx'
    session['password'] = '123456'
    return 'success'

from flask import session, jsonify

@app.route('/login')
def login():
    user_name = session.get('username')
    pass_word = session.get('password')
    if user_name == "xxx" and pass_word == "123456":
        return jsonify({"status": 1, "msg": "success"})
    else:
        return jsonify({"status": 0, "msg": "failed"})

pip install flask-sqlalchemy
pip install pymysql  # MySQL 驱动

from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

HOST = '127.0.0.1'
PORT = '3306'
DATABASE = 'test'
USERNAME = 'root'
PASSWORD = '123456'

DB_URI = "mysql+pymysql://{username}:{password}@{host}:{port}/{db}?charset=utf8".format(
    username=USERNAME, password=PASSWORD, host=HOST, port=PORT, db=DATABASE
)

SQLALCHEMY_DATABASE_URI = DB_URI
SQLALCHEMY_TRACK_MODIFICATIONS = False
SQLALCHEMY_ECHO = True

from flask import Flask
import config
from exts import db

app = Flask(__name__)
app.config.from_object(config)
db.init_app(app)

from exts import db

class User(db.Model):
    __tablename__ = "User"
    uid = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80), unique=True)
    email = db.Column(db.String(120), unique=True)

    def __init__(self, username, email):
        self.username = username
        self.email = email

    def __repr__(self):
        return '<User %r>' % self.username

from models import User

db.create_all()  # 必须在视图函数中调用

user_obj = User(username='test', email='[email protected]')
db.session.add(user_obj)
db.session.commit()

# 查询所有
users = User.query.all()
# 根据 ID 查询
user = User.query.get(1)
# 过滤查询
users = User.query.filter(User.username.startswith('l')).all()
# 分页
page = User.query.paginate(page=1, per_page=10, error_out=False)

user = User.query.get(1)
user.username = 'new_name'
db.session.commit()

user = User.query.get(1)
db.session.delete(user)
db.session.commit()

class User(db.Model):
    __tablename__ = 'user'
    nid = db.Column(db.Integer, primary_key=True, autoincrement=True)
    username = db.Column(db.String(16), nullable=False)
    articles = db.relationship("Article", backref="author")

class Article(db.Model):
    __tablename__ = 'Article'
    nid = db.Column(db.Integer, primary_key=True, autoincrement=True)
    title = db.Column(db.String(36), nullable=False)
    author_id = db.Column(db.Integer, db.ForeignKey("user.nid"))

student_course = db.Table('student_course',
    db.Column('student_id', db.Integer, db.ForeignKey('student.id')),
    db.Column('course_id', db.Integer, db.ForeignKey('course.id')))

class Student(db.Model):
    __tablename__ = 'student'
    id = db.Column(db.Integer, primary_key=True)
    courses = db.relationship('Course', secondary=student_course)

class Course(db.Model):
    __tablename__ = 'course'
    id = db.Column(db.Integer, primary_key=True)

pip install flask-migrate

from flask_migrate import Migrate
migrate = Migrate(app, db)

flask db init
flask db migrate -m "initial migration"
flask db upgrade

@app.errorhandler(404)
def not_found(error):
    return "Page Not Found", 404

@app.errorhandler(500)
def internal_error(error):
    return "Internal Server Error", 500

Python Flask 框架快速入门与核心应用

一、项目初始化

1. 创建简单应用

二、路由规则

1. 简单路由

2. 带参数的路由

2.1 不限定类型

2.2 限定类型

3. 正则路由

4. 限定请求方式

三、响应规则

1. HTML 响应

1.1 HTML 文本

1.2 HTML 文件

2. JSON 响应

3. 重定向

4. 视图跳转

5. 状态码

四、模板引擎

1. 变量

2. 注释

3. 过滤器

3.1 常用过滤器

3.2 自定义过滤器

4. 标签

4.1 if

4.2 for

5. 导入与继承

五、获取请求数据

六、会话控制

1. Cookie

1.1 设置 Cookie

1.2 获取 Cookie

2. Session

2.1 配置 SECRET_KEY

2.2 设置 Session

2.3 获取 Session

七、ORM 模型 (SQLAlchemy)

1. 安装

2. 配置

3. 表操作

3.1 定义模型

3.2 CRUD 操作

4. 关系映射

4.1 一对多

4.2 多对多

5. 数据库迁移

八、最佳实践与安全

1. 配置管理

2. 错误处理

3. 安全性

4. 项目结构

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具