百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

Flask 入门教程

wptr33 2025-04-24 09:19 24 浏览

目录

  1. 什么是Flask?
  2. 环境配置与安装
  3. 第一个Flask应用:Hello World
  4. 路由与视图函数
  5. 模板与Jinja2
  6. 表单处理与用户输入
  7. 数据库集成(SQLite + SQLAlchemy)
  8. 错误处理与调试
  9. 完整示例:待办事项应用
  10. 下一步学习建议

1. 什么是Flask?

  • Flask 是一个轻量级的Python Web框架,基于Werkzeug WSGI工具包和Jinja2模板引擎,适合快速开发小型到中型的Web应用。

核心特点

  • 简单易学:代码简洁,文档清晰。
  • 灵活可扩展:通过插件支持数据库、表单验证、用户认证等功能。
  • RESTful友好:天然支持构建API。
  • 开发友好:内置调试模式,支持热重载。

2. 环境配置与安装

步骤详解:

  1. 安装Python
  • 推荐使用Python 3.8+,可访问Python官网下载安装。
  • 验证安装:
python --version # 输出应为3.8+
  1. 创建虚拟环境(必做)
  • 作用:隔离项目依赖,避免版本冲突。
  • 操作
# 创建虚拟环境 
python -m venv flask_env 
# 激活虚拟环境
source flask_env/bin/activate # Linux/MacOS 
.\flask_env\Scripts\activate # Windows(PowerShell)
  1. 安装Flask
pip install Flask

3. 第一个Flask应用:Hello World

完整代码示例:

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello World!'

if __name__ == '__main__':
    app.run(debug=True)  # 启用调试模式

运行与验证:

  1. 保存文件为 app.py。
  2. 在终端运行:
python app.py
  1. 访问 http://127.0.0.1:5000/,页面显示 "Hello World!"。

关键点解释:

  • Flask(__name__):创建应用实例,__name__用于确定资源路径。
  • @app.route('/'):装饰器将URL路径/绑定到视图函数hello。
  • debug=True:开启调试模式,修改代码后自动重启服务,并在浏览器显示错误详情。

4. 路由与视图函数

核心概念:

  • 路由:URL路径与视图函数的映射。
  • 视图函数:接收请求并返回响应(字符串、HTML、JSON等)。

动态路由示例:

@app.route('/user/<username>')
def show_user(username):
    return f'User: {username}'

@app.route('/post/<int:post_id>')
def show_post(post_id):
    return f'Post ID: {post_id}'

路由参数类型:

类型

说明

示例

string

默认类型(不含斜杠)

/user/<username>

int

整数

/post/<int:id>

float

浮点数

/price/<float:val>

path

包含斜杠的字符串

/path/<path:sub>

5. 模板与Jinja2

为什么需要模板?

  • 分离逻辑与表现:将HTML与Python代码解耦。
  • 动态渲染:通过变量、循环、条件生成页面。

使用步骤:

  1. 创建模板目录
    项目根目录下新建 templates 文件夹(Flask默认查找此目录)。
  2. 编写基础模板(templates/base.html)
<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}{% endblock %}</title>
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>
  1. 子模板继承(templates/index.html)
{% extends "base.html" %}
{% block title %}Home{% endblock %}
{% block content %}
  <h1>{{ message }}</h1>
  <ul>
    {% for item in items %}
      <li>{{ item }}</li>
    {% endfor %}
  </ul>
{% endblock %}
  1. 视图函数渲染
from flask import render_template

@app.route('/')
def index():
    return render_template('index.html', 
                         message='Welcome!',
                         items=['Apple', 'Banana', 'Cherry'])

6. 表单处理与用户输入

安全提示:

  • 启用CSRF保护:生产环境中需使用Flask-WTF扩展,此处为简化示例。

表单处理示例:

  1. HTML表单(templates/form.html)
<form method="POST" action="/submit">
    <input type="text" name="username" placeholder="Username" required>
    <input type="email" name="email" placeholder="Email" required>
    <button type="submit">Submit</button>
</form>
  1. 视图函数处理
from flask import request, redirect

@app.route('/form')
def show_form():
    return render_template('form.html')

@app.route('/submit', methods=['POST'])
def submit():
    username = request.form.get('username')
    email = request.form.get('email')
    # 此处应添加数据验证逻辑
    return redirect(f'/user/{username}')

7. 数据库集成(SQLite + SQLAlchemy)

使用Flask-SQLAlchemy简化操作:

  1. 安装扩展
pip install flask-sqlalchemy
  1. 配置数据库(app.py)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)
  1. 定义数据模型
class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(50), unique=True, nullable=False)
    email = db.Column(db.String(120), unique=True, nullable=False)

    def __repr__(self):
        return f"User('{self.username}', '{self.email}')"
  1. 初始化数据库
# 在Python交互环境中执行
from app import db
db.create_all()
  1. CRUD操作示例
# 创建用户
new_user = User(username='john', email='john@example.com')
db.session.add(new_user)
db.session.commit()

# 查询用户
user = User.query.filter_by(username='john').first()

# 删除用户
db.session.delete(user)
db.session.commit()

8. 错误处理与调试

自定义错误页面:

@app.errorhandler(404)
def page_not_found(error):
    return render_template('404.html'), 404

调试模式的高级用法:

  • 开启调试器:浏览器中直接调试代码(仅限开发环境)。
  • 日志记录
import logging 
logging.basicConfig( 
    level=logging.DEBUG, 
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s' )

9. 完整示例:待办事项应用(优化版)

代码结构:

todo-app/
├── app.py
├── templates/
│   ├── base.html
│   ├── index.html
│   └── 404.html
└── site.db

关键代码:

app.py

from flask import Flask, render_template, request, redirect, url_for
from flask_sqlalchemy import SQLAlchemy

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
db = SQLAlchemy(app)

class Todo(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    content = db.Column(db.String(200), nullable=False)
    completed = db.Column(db.Boolean, default=False)

@app.route('/')
def index():
    todos = Todo.query.all()
    return render_template('index.html', todos=todos)

@app.route('/add', methods=['POST'])
def add():
    content = request.form.get('content')
    if content:
        new_todo = Todo(content=content)
        db.session.add(new_todo)
        db.session.commit()
    return redirect(url_for('index'))

@app.route('/delete/<int:id>')
def delete(id):
    todo = Todo.query.get_or_404(id)
    db.session.delete(todo)
    db.session.commit()
    return redirect(url_for('index'))

if __name__ == '__main__':
    with app.app_context():
        db.create_all()  # 自动创建数据库表
    app.run(debug=True)

templates/index.html

{% extends "base.html" %}
{% block title %}Todo List{% endblock %}
{% block content %}
  <h1>Todo List</h1>
  <form method="POST" action="{{ url_for('add') }}">
      <input type="text" name="content" placeholder="New task" required>
      <button type="submit">Add</button>
  </form>
  <ul>
      {% for todo in todos %}
      <li>
          {% if todo.completed %}<s>{% endif %}
          {{ todo.content }}
          {% if todo.completed %}</s>{% endif %}
          <a href="{{ url_for('delete', id=todo.id) }}">Delete</a>
      </li>
      {% endfor %}
  </ul>
{% endblock %}

10. 下一步学习建议

  1. 扩展功能
  • 用户认证:使用Flask-Login管理用户会话。
  • 表单验证:通过Flask-WTF添加CSRF保护和表单验证。
  • 前端增强:集成Bootstrap或JavaScript框架(如Vue.js)。
  1. 部署实践
  • 使用Gunicorn + Nginx部署到Linux服务器。
  • 尝试云平台部署(如Heroku、AWS EC2)。
  1. 深入学习
  • 阅读Flask官方文档
  • 学习REST API开发(Flask-RESTful扩展)
  • 探索大型项目结构(蓝图、工厂模式)

通过本教程,你已掌握Flask的核心功能,包括路由、模板、数据库操作和错误处理。接下来,尝试为你的应用添加更多功能,并探索Flask生态系统的强大扩展能力!

相关推荐

MySQL进阶五之自动读写分离mysql-proxy

自动读写分离目前,大量现网用户的业务场景中存在读多写少、业务负载无法预测等情况,在有大量读请求的应用场景下,单个实例可能无法承受读取压力,甚至会对业务产生影响。为了实现读取能力的弹性扩展,分担数据库压...

Postgres vs MySQL_vs2022连接mysql数据库

...

3分钟短文 | Laravel SQL筛选两个日期之间的记录,怎么写?

引言今天说一个细分的需求,在模型中,或者使用laravel提供的EloquentORM功能,构造查询语句时,返回位于两个指定的日期之间的条目。应该怎么写?本文通过几个例子,为大家梳理一下。学习时...

一文由浅入深带你完全掌握MySQL的锁机制原理与应用

本文将跟大家聊聊InnoDB的锁。本文比较长,包括一条SQL是如何加锁的,一些加锁规则、如何分析和解决死锁问题等内容,建议耐心读完,肯定对大家有帮助的。为什么需要加锁呢?...

验证Mysql中联合索引的最左匹配原则

后端面试中一定是必问mysql的,在以往的面试中好几个面试官都反馈我Mysql基础不行,今天来着重复习一下自己的弱点知识。在Mysql调优中索引优化又是非常重要的方法,不管公司的大小只要后端项目中用到...

MySQL索引解析(联合索引/最左前缀/覆盖索引/索引下推)

目录1.索引基础...

你会看 MySQL 的执行计划(EXPLAIN)吗?

SQL执行太慢怎么办?我们通常会使用EXPLAIN命令来查看SQL的执行计划,然后根据执行计划找出问题所在并进行优化。用法简介...

MySQL 从入门到精通(四)之索引结构

索引概述索引(index),是帮助MySQL高效获取数据的数据结构(有序),在数据之外,数据库系统还维护者满足特定查询算法的数据结构,这些数据结构以某种方式引用(指向)数据,这样就可以在这些数据结构...

mysql总结——面试中最常问到的知识点

mysql作为开源数据库中的榜一大哥,一直是面试官们考察的重中之重。今天,我们来总结一下mysql的知识点,供大家复习参照,看完这些知识点,再加上一些边角细节,基本上能够应付大多mysql相关面试了(...

mysql总结——面试中最常问到的知识点(2)

首先我们回顾一下上篇内容,主要复习了索引,事务,锁,以及SQL优化的工具。本篇文章接着写后面的内容。性能优化索引优化,SQL中索引的相关优化主要有以下几个方面:最好是全匹配。如果是联合索引的话,遵循最...

MySQL基础全知全解!超详细无废话!轻松上手~

本期内容提醒:全篇2300+字,篇幅较长,可搭配饭菜一同“食”用,全篇无废话(除了这句),干货满满,可收藏供后期反复观看。注:MySQL中语法不区分大小写,本篇中...

深入剖析 MySQL 中的锁机制原理_mysql 锁详解

在互联网软件开发领域,MySQL作为一款广泛应用的关系型数据库管理系统,其锁机制在保障数据一致性和实现并发控制方面扮演着举足轻重的角色。对于互联网软件开发人员而言,深入理解MySQL的锁机制原理...

Java 与 MySQL 性能优化:MySQL分区表设计与性能优化全解析

引言在数据库管理领域,随着数据量的不断增长,如何高效地管理和操作数据成为了一个关键问题。MySQL分区表作为一种有效的数据管理技术,能够将大型表划分为多个更小、更易管理的分区,从而提升数据库的性能和可...

MySQL基础篇:DQL数据查询操作_mysql 查

一、基础查询DQL基础查询语法SELECT字段列表FROM表名列表WHERE条件列表GROUPBY分组字段列表HAVING分组后条件列表ORDERBY排序字段列表LIMIT...

MySql:索引的基本使用_mysql索引的使用和原理

一、索引基础概念1.什么是索引?索引是数据库表的特殊数据结构(通常是B+树),用于...