Flask 入门教程
wptr33 2025-04-24 09:19 14 浏览
目录
- 什么是Flask?
- 环境配置与安装
- 第一个Flask应用:Hello World
- 路由与视图函数
- 模板与Jinja2
- 表单处理与用户输入
- 数据库集成(SQLite + SQLAlchemy)
- 错误处理与调试
- 完整示例:待办事项应用
- 下一步学习建议
1. 什么是Flask?
- Flask 是一个轻量级的Python Web框架,基于Werkzeug WSGI工具包和Jinja2模板引擎,适合快速开发小型到中型的Web应用。
核心特点:
- 简单易学:代码简洁,文档清晰。
- 灵活可扩展:通过插件支持数据库、表单验证、用户认证等功能。
- RESTful友好:天然支持构建API。
- 开发友好:内置调试模式,支持热重载。
2. 环境配置与安装
步骤详解:
- 安装Python
- 推荐使用Python 3.8+,可访问Python官网下载安装。
- 验证安装:
python --version # 输出应为3.8+
- 创建虚拟环境(必做)
- 作用:隔离项目依赖,避免版本冲突。
- 操作:
# 创建虚拟环境
python -m venv flask_env
# 激活虚拟环境
source flask_env/bin/activate # Linux/MacOS
.\flask_env\Scripts\activate # Windows(PowerShell)
- 安装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) # 启用调试模式
运行与验证:
- 保存文件为 app.py。
- 在终端运行:
python app.py
- 访问 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代码解耦。
- 动态渲染:通过变量、循环、条件生成页面。
使用步骤:
- 创建模板目录
项目根目录下新建 templates 文件夹(Flask默认查找此目录)。 - 编写基础模板(templates/base.html)
<!DOCTYPE html>
<html>
<head>
<title>{% block title %}{% endblock %}</title>
</head>
<body>
{% block content %}{% endblock %}
</body>
</html>
- 子模板继承(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 %}
- 视图函数渲染
from flask import render_template
@app.route('/')
def index():
return render_template('index.html',
message='Welcome!',
items=['Apple', 'Banana', 'Cherry'])
6. 表单处理与用户输入
安全提示:
- 启用CSRF保护:生产环境中需使用Flask-WTF扩展,此处为简化示例。
表单处理示例:
- 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>
- 视图函数处理
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简化操作:
- 安装扩展
pip install flask-sqlalchemy
- 配置数据库(app.py)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
db = SQLAlchemy(app)
- 定义数据模型
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}')"
- 初始化数据库
# 在Python交互环境中执行
from app import db
db.create_all()
- 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. 下一步学习建议
- 扩展功能:
- 用户认证:使用Flask-Login管理用户会话。
- 表单验证:通过Flask-WTF添加CSRF保护和表单验证。
- 前端增强:集成Bootstrap或JavaScript框架(如Vue.js)。
- 部署实践:
- 使用Gunicorn + Nginx部署到Linux服务器。
- 尝试云平台部署(如Heroku、AWS EC2)。
- 深入学习:
- 阅读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)就是我们的"时光机"。它默默记录着数据库的每一个重要变更,就像一位忠实的史官,为我们在数据灾难中提供最后的救命稻草。本文将带您深入掌握如...
- 一周热门
-
-
C# 13 和 .NET 9 全知道 :13 使用 ASP.NET Core 构建网站 (1)
-
因果推断Matching方式实现代码 因果推断模型
-
git pull命令使用实例 git pull--rebase
-
面试官:git pull是哪两个指令的组合?
-
git 执行pull错误如何撤销 git pull fail
-
git pull 和git fetch 命令分别有什么作用?二者有什么区别?
-
git fetch 和git pull 的异同 git中fetch和pull的区别
-
git pull 之后本地代码被覆盖 解决方案
-
还可以这样玩?Git基本原理及各种骚操作,涨知识了
-
git命令之pull git.pull
-
- 最近发表
-
- 每天一个编程技巧!掌握这7个神技,代码效率飙升200%
- Git重置到某个历史节点(Sourcetree工具)
- git工作区、暂存区、本地仓库、远程仓库的区别和联系
- 解锁人生新剧本的密钥:学会让往事退场
- Reset local repository branch to be just like remote repository HEAD
- Git恢复至之前版本(git恢复到pull之前的版本)
- 如何将文件重置或回退到特定版本(怎么让文件回到初始状态)
- git如何正确回滚代码(git命令回滚代码)
- [git]撤销的相关命令:reset、revert、checkout
- 利用shell脚本将Mysql错误日志保存到数据库中
- 标签列表
-
- git pull (33)
- git fetch (35)
- mysql insert (35)
- mysql distinct (37)
- concat_ws (36)
- java continue (36)
- jenkins官网 (37)
- mysql 子查询 (37)
- python元组 (33)
- mybatis 分页 (35)
- vba split (37)
- redis watch (34)
- python list sort (37)
- nvarchar2 (34)
- mysql not null (36)
- hmset (35)
- python telnet (35)
- python readlines() 方法 (36)
- munmap (35)
- docker network create (35)
- redis 集合 (37)
- python sftp (37)
- setpriority (34)
- c语言 switch (34)
- git commit (34)