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

Flask 入门教程

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

目录

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

相关推荐

每天一个编程技巧!掌握这7个神技,代码效率飙升200%

“同事6点下班,你却为改BUG加班到凌晨?不是你不努力,而是没掌握‘偷懒’的艺术!本文揭秘谷歌工程师私藏的7个编程神技,每天1分钟,让你的代码从‘能用’变‘逆天’。文末附《Python高效代码模板》,...

Git重置到某个历史节点(Sourcetree工具)

前言Sourcetree回滚提交和重置当前分支到此次提交的区别?回滚提交是指将改动的代码提交到本地仓库,但未推送到远端仓库的时候。...

git工作区、暂存区、本地仓库、远程仓库的区别和联系

很多程序员天天写代码,提交代码,拉取代码,对git操作非常熟练,但是对git的原理并不甚了解,借助豆包AI,写个文章总结一下。Git的四个核心区域(工作区、暂存区、本地仓库、远程仓库)是版本控制的核...

解锁人生新剧本的密钥:学会让往事退场

开篇:敦煌莫高窟的千年启示在莫高窟321窟的《降魔变》壁画前,讲解员指着斑驳色彩说:"画师刻意保留了历代修补痕迹,因为真正的传承不是定格,而是流动。"就像我们的人生剧本,精彩章节永远...

Reset local repository branch to be just like remote repository HEAD

技术背景在使用Git进行版本控制时,有时会遇到本地分支与远程分支不一致的情况。可能是因为误操作、多人协作时远程分支被更新等原因。这时就需要将本地分支重置为与远程分支的...

Git恢复至之前版本(git恢复到pull之前的版本)

让程序回到提交前的样子:两种解决方法:回退(reset)、反做(revert)方法一:gitreset...

如何将文件重置或回退到特定版本(怎么让文件回到初始状态)

技术背景在使用Git进行版本控制时,经常会遇到需要将文件回退到特定版本的情况。可能是因为当前版本出现了错误,或者想要恢复到之前某个稳定的版本。Git提供了多种方式来实现这一需求。...

git如何正确回滚代码(git命令回滚代码)

方法一,删除远程分支再提交①首先两步保证当前工作区是干净的,并且和远程分支代码一致$gitcocurrentBranch$gitpullorigincurrentBranch$gi...

[git]撤销的相关命令:reset、revert、checkout

基本概念如果不清晰上面的四个概念,请查看廖老师的git教程这里我多说几句:最开始我使用git的时候,我并不明白我为什么写完代码要用git的一些列指令把我的修改存起来。后来用多了,也就明白了为什么。gi...

利用shell脚本将Mysql错误日志保存到数据库中

说明:利用shell脚本将MYSQL的错误日志提取并保存到数据库中步骤:1)创建数据库,创建表CreatedatabaseMysqlCenter;UseMysqlCenter;CREATET...

MySQL 9.3 引入增强的JavaScript支持

MySQL,这一广泛采用的开源关系型数据库管理系统(RDBMS),发布了其9.x系列的第三个更新版本——9.3版,带来了多项新功能。...

python 连接 mysql 数据库(python连接MySQL数据库案例)

用PyMySQL包来连接Python和MySQL。在使用前需要先通过pip来安装PyMySQL包:在windows系统中打开cmd,输入pipinstallPyMySQL ...

mysql导入导出命令(mysql 导入命令)

mysql导入导出命令mysqldump命令的输入是在bin目录下.1.导出整个数据库  mysqldump-u用户名-p数据库名>导出的文件名  mysqldump-uw...

MySQL-SQL介绍(mysql sqlyog)

介绍结构化查询语言是高级的非过程化编程语言,允许用户在高层数据结构上工作。它不要求用户指定对数据的存放方法,也不需要用户了解具体的数据存放方式,所以具有完全不同底层结构的不同数据库系统,可以使用相同...

MySQL 误删除数据恢复全攻略:基于 Binlog 的实战指南

在MySQL的世界里,二进制日志(Binlog)就是我们的"时光机"。它默默记录着数据库的每一个重要变更,就像一位忠实的史官,为我们在数据灾难中提供最后的救命稻草。本文将带您深入掌握如...