百度360必应搜狗淘宝本站头条
mysql distinctjenkins官网mysql 子查询vba splitpython list sort
当前位置：网站首页 > IT技术 > 正文

Flask 入门教程

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

目录

  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生态系统的强大扩展能力！

相关推荐

Linux高性能服务器设计

C10K和C10M计算机领域的很多技术都是需求推动的，上世纪90年代，由于互联网的飞速发展，网络服务器无法支撑快速增长的用户规模。1999年，DanKegel提出了著名的C10问题：一台服务器上同时...

独立游戏开发者常犯的十大错误

...

学C了一头雾水该咋办?

学C了一头雾水该怎么办？最简单的方法就是你再学一遍呗。俗话说熟能生巧，铁杵也能磨成针。但是一味的为学而学，这个好像没什么卵用。为什么学了还是一头雾水，重点就在这，找出为什么会这个样子？１、概念理解不深...

C++基础语法梳理:inline 内联函数!虚函数可以是内联函数吗?

上节我们分析了C++基础语法的const，static以及this指针，那么这节内容我们来看一下inline内联函数吧！inline内联函数...

C语言实战小游戏:井字棋(三子棋)大战!文内含有源码

井字棋是黑白棋的一种。井字棋是一种民间传统游戏，又叫九宫棋、圈圈叉叉、一条龙、三子旗等。将正方形对角线连起来，相对两边依次摆上三个双方棋子，只要将自己的三个棋子走成一条线，对方就算输了。但是，有很多时...

C++语言到底是不是C语言的超集之一

C与C++两个关系亲密的编程语言，它们本质上是两中语言，只是C++语言设计时要求尽可能的兼容C语言特性，因此C语言中99%以上的功能都可以使用C++完成。本文探讨那些存在于C语言中的特性，但是在C++...

在C++中，如何避免出现Bug?

C++中的主要问题之一是存在大量行为未定义或对程序员来说意外的构造。我们在使用静态分析器检查各种项目时经常会遇到这些问题。但正如我们所知，最佳做法是在编译阶段尽早检测错误。让我们来看看现代C++中的一...

ESL-通过事件控制FreeSWITCH

通过事件提供的最底层控制机制，允许我们有效地利用工具箱，适时选择使用其中的单个工具。FreeSWITCH是一个核心交换与混合矩阵，它周围有几十个模块提供各种功能特性。我们完全控制了所有的即时信息，这些...

物理老师教你学C++语言(中篇)

一、条件语句与实验判断...

C语言入门指南

当然！以下是关于C语言入门编程的基础介绍和入门建议，希望能帮你顺利起步：C语言入门指南...

C++选择结构，让程序自动进行决策

什么是选择结构？正常的程序都是从上至下顺序执行，这就是顺序结构...

C++特性使用建议

1.引用参数使用引用替代指针且所有不变的引用参数必须加上const。在C语言中，如果函数需要修改变量的值，参数必须为指针，如...

C++程序员学习Zig指南(中篇)

1.复合数据类型结构体与方法的对比C++类：...

研一自学C++啃得动吗?

研一自学C++啃得动吗?在开始前我有一些资料，是我根据网友给的问题精心整理了一份「C++的资料从专业入门到高级教程」，点个关注在评论区回复“888”之后私信回复“888”，全部无偿共享给大家！！！个人...

C++关键字介绍

下表列出了C++中的常用关键字，这些关键字不能作为变量名或其他标识符名称。1、autoC++11的auto用于表示变量的自动类型推断。即在声明变量的时候，根据变量初始值的类型自动为此变量选择匹配的...

一周热门
最近发表
标签列表
Copyright Your WebSite.Some Rights Reserved.