flask是快速搭建rest api服务的轻量级首选框架，其核心功能包括：1.路由和视图函数：通过@app.route()绑定url路径与处理逻辑，支持多种http方法，并建议将视图函数拆分到蓝图中以保持结构清晰；2.请求与响应处理：使用request对象获取参数或数据，返回值自动转换为响应对象，支持显式使用jsonify构造json响应；3.使用flask-restful扩展：提供基于类的资源型接口设计，简化标准rest api开发，支持参数类型转换及内置请求解析；4.中间件与错误处理：通过errorhandler自定义错误响应，利用钩子函数实现日志、鉴权、cors等通用操作，从而提升稳定性和可维护性，合理规划细节可显著提高开发效率。
做Python后端开发，特别是快速搭建REST API服务时，很多人首选Flask。它不像Django那样功能齐全、结构固定，但轻量灵活、上手快，特别适合中小型项目或者原型开发。如果你打算用Flange来写API接口，掌握它的核心功能是关键。
路由和视图函数：API的基础骨架
Flask通过@app.route()装饰器来定义路由，把URL路径和处理逻辑绑定起来。这是构建REST API的第一步。
比如：
立即学习“Python免费学习笔记（深入）”；
@app.route('/users', methods=['GET'])
def get_users():
return {"users": ["Alice", "Bob"]}这个例子中，访问 /users 会返回一个用户列表，使用GET方法。
你可以根据需求添加不同HTTP方法，如POST、PUT、DELETE等，并在视图函数中实现对应逻辑。
几点建议：
- 尽量把视图函数拆到单独的模块或蓝图（Blueprint）里，避免主文件臃肿。
- 使用
request对象获取请求数据，比如request.json可以拿到POST过来的JSON数据。 - 返回值可以用字典或字符串，Flask会自动转成响应对象。
请求与响应处理：让API真正“动”起来
一个完整的API不仅要有路由，还要能处理各种输入输出。Flask提供了request和response对象，用来解析客户端发来的请求内容，并构造合适的返回结果。
常用操作包括：
- 获取查询参数：
request.args.get('name') - 获取POST数据：
request.form或request.json - 构造响应：直接return字典会自动转成JSON，也可以用
jsonify()显式包装
举个例子，假设你希望接收一个用户名作为参数并返回欢迎信息：
@app.route('/greet')
def greet():
name = request.args.get('name', 'Guest')
return {"message": f"Hello, {name}!"}这时候访问 /greet?name=Tom，就能看到对应的问候语。
使用Flask-RESTful扩展简化开发流程
虽然原生Flask已经足够强大，但如果要做更标准的REST API，推荐使用 Flask-RESTful 扩展。它提供了一个基于类的视图方式，更适合组织资源型接口。
安装后可以这样写：
from flask_restful import Resource, Api
api = Api(app)
class UserResource(Resource):
def get(self, user_id):
return {"user_id": user_id}
api.add_resource(UserResource, '/users/<int:user_id>')这种方式有几个好处：
- 更清晰地划分资源和方法
- 支持参数类型自动转换（如
<user_id></user_id>） - 内置支持请求解析、错误处理等功能
如果你的API规模稍大一些，或者希望接口设计更规范，用这个扩展会让你事半功倍。
中间件和错误处理：提升稳定性和可维护性
实际部署中，API难免会遇到异常情况，比如参数缺失、路径不存在、服务器内部错误等。Flask允许你使用@app.errorhandler()来自定义错误响应。
例如：
@app.errorhandler(404)
def not_found(error):
return {"error": "Resource not found"}, 404此外，还可以使用中间件（比如通过before_request和after_request钩子）做一些通用处理，比如日志记录、身份验证、设置CORS头等。
常见做法包括：
- 在请求前检查token是否有效
- 统一设置响应头，比如Content-Type或Access-Control-Allow-Origin
- 记录每个请求的耗时或状态码用于监控
基本上就这些。Flask虽然小，但只要用好这几个核心功能，完全可以胜任大多数REST API开发任务。不复杂，但容易忽略细节，尤其是错误处理和结构组织方面，多花点时间规划会省不少后续麻烦。
