当前位置：首页 > article >正文

python web flask专题-Flask入门指南：从安装到核心功能详解

article 2025/8/19 1:50:19

Flask入门指南：从安装到核心功能详解

Flask作为Python最流行的轻量级Web框架之一，以其简洁灵活的特性广受开发者喜爱。本文将带你从零开始学习Flask，涵盖安装配置、项目结构、应用实例、路由系统以及请求响应处理等核心知识点。
在这里插入图片描述

1. Flask安装与项目结构

1.1 安装Flask

在开始之前，请确保已安装Python（建议3.6+版本）。通过pip安装Flask：

pip install flask

验证安装是否成功：

python -c "import flask; print(flask.__version__)"

1.2 最小Flask应用

创建一个最简单的Flask应用app.py：

from flask import Flaskapp = Flask(__name__)@app.route('/')
def hello():return 'Hello, World!'if __name__ == '__main__':app.run(debug=True)

运行应用：

python app.py

访问http://127.0.0.1:5000即可看到"Hello, World!"。

代码解释：

Flask(__name__)创建应用实例，__name__确定应用根目录
@app.route('/')装饰器定义路由
app.run(debug=True)启动开发服务器，debug=True启用调试模式

1.3 基本项目结构

随着项目增长，推荐的组织结构：

/flask_project/app/static       # 静态文件(CSS, JS, 图片)/templates    # 模板文件(HTML)__init__.py   # 应用工厂函数routes.py     # 路由定义models.py     # 数据模型config.py         # 配置文件requirements.txt  # 依赖列表

2. Flask应用实例配置详解

2.1 应用工厂模式

使用工厂函数创建应用更灵活：

# app/__init__.py
from flask import Flask
from . import routesdef create_app(config_filename=None):app = Flask(__name__)# 加载配置if config_filename:app.config.from_pyfile(config_filename)else:app.config.from_mapping(SECRET_KEY='dev',DATABASE='sqlite:///app.db',)# 注册蓝图或路由app.register_blueprint(routes.bp)return app

2.2 常用配置项

Flask配置可以通过多种方式设置：

# 直接设置
app.config['SECRET_KEY'] = 'your-secret-key'# 从对象加载
class Config:SECRET_KEY = 'your-secret-key'DEBUG = True
app.config.from_object(Config)# 从文件加载
app.config.from_pyfile('config.py')# 常用配置项：
# DEBUG - 是否启用调试模式
# TESTING - 是否启用测试模式
# SECRET_KEY - 加密会话的密钥
# SESSION_COOKIE_NAME - 会话cookie名称
# PERMANENT_SESSION_LIFETIME - 持久会话有效期

3. 路由定义详解

3.1 基本路由

@app.route('/')
def index():return '首页'@app.route('/about')
def about():return '关于我们'

3.2 动态路由

@app.route('/user/<username>')
def show_user(username):return f'用户: {username}'@app.route('/post/<int:post_id>')
def show_post(post_id):return f'文章ID: {post_id}'

路由转换器类型：

string: (默认)接受任何不包含斜线的文本
int: 接受正整数
float: 接受正浮点数
path: 类似string但包含斜线
uuid: 接受UUID字符串

3.3 HTTP方法

@app.route('/login', methods=['GET', 'POST'])
def login():if request.method == 'POST':return do_login()else:return show_login_form()

3.4 URL生成

使用url_for()生成URL：

from flask import url_for@app.route('/')
def index():print(url_for('login'))  # 输出: /loginprint(url_for('show_user', username='john'))  # 输出: /user/johnreturn '首页'

4. 请求与响应处理

4.1 请求对象(Request)

Flask自动将请求数据封装在request对象中：

from flask import request@app.route('/search')
def search():query = request.args.get('q', '')  # 获取查询参数return f'搜索: {query}'@app.route('/submit', methods=['POST'])
def submit():username = request.form['username']  # 获取表单数据file = request.files['avatar']      # 获取上传文件return f'用户名: {username}'

常用request属性：

args: GET请求参数 (查询字符串)
form: POST表单数据
files: 上传的文件
headers: 请求头
method: 请求方法
json: 解析后的JSON数据

4.2 响应对象(Response)

视图函数可以返回多种类型的响应：

from flask import make_response, jsonify, redirect# 返回字符串
@app.route('/text')
def text_response():return '纯文本响应'# 返回JSON
@app.route('/json')
def json_response():return jsonify({'status': 'success', 'data': [1, 2, 3]})# 自定义响应
@app.route('/custom')
def custom_response():response = make_response('自定义响应')response.headers['X-Custom-Header'] = 'Value'response.status_code = 201return response# 重定向
@app.route('/old')
def old_route():return redirect('/new')

4.3 处理文件上传

from werkzeug.utils import secure_filename@app.route('/upload', methods=['POST'])
def upload_file():if 'file' not in request.files:return '没有文件部分'file = request.files['file']if file.filename == '':return '没有选择文件'if file and allowed_file(file.filename):filename = secure_filename(file.filename)file.save(os.path.join(app.config['UPLOAD_FOLDER'], filename))return '文件上传成功'

4.4 处理Cookie

@app.route('/set-cookie')
def set_cookie():resp = make_response('设置Cookie')resp.set_cookie('username', 'john', max_age=3600)return resp@app.route('/get-cookie')
def get_cookie():username = request.cookies.get('username')return f'用户名: {username}'