Flask 由浅入深全解：从零基础入门到企业级工程化实战

python
# 安装最新版Flask
pip install flask

# 查看版本
flask --version

python
# 导入核心类
from flask import Flask

# 初始化Flask应用实例
# __name__ 代表当前模块名，Flask通过它定位静态资源、模板文件
app = Flask(__name__)

# 路由装饰器：绑定URL路径与视图函数
@app.route('/')
def index():
    # 视图函数：接收请求，返回响应（文本、HTML、JSON等）
    return "Hello Flask！零基础入门第一个Web程序"

# 程序入口
if __name__ == '__main__':
    # 启动服务，默认本地5000端口
    app.run(debug=True)

python
python app.py

新手必避坑：项目文件名绝对不能命名为 flask.py，会与框架本身冲突，导致运行报错！

python
@app.route('/about')
def about():
    return "关于我们页面"

python
# 整型参数
@app.route('/user/<int:uid>')
def user_detail(uid):
    return f"用户ID：{uid}"

# 路径参数（支持带斜杠的复杂路径）
@app.route('/file/<path:filename>')
def get_file(filename):
    return f"文件路径：{filename}"

python
@app.route('/api/submit', methods=['GET', 'POST'])
def submit():
    return "支持GET和POST请求"

python
from flask import request

@app.route('/api/info', methods=['GET', 'POST'])
def get_info():
    # 1. 获取URL查询参数 ?name=xxx&age=xxx
    name = request.args.get('name', '默认用户名')
    age = request.args.get('age', 18, type=int)

    # 2. 获取POST表单参数
    username = request.form.get('username')

    # 3. 获取JSON接口参数（前后端分离必备）
    json_data = request.get_json(silent=True)

    # 4. 获取请求头
    user_agent = request.headers.get('User-Agent')
    
    return f"姓名：{name}，年龄：{age}"

python
from flask import jsonify, redirect, url_for, render_template

# 1. 基础文本响应
@app.route('/text')
def text_res():
    return "普通文本响应"

# 2. JSON响应（接口开发核心）
@app.route('/api/json')
def json_res():
    # 自动设置Content-Type为application/json
    return jsonify(code=200, msg="请求成功", data={"name":"Flask", "version":"2.0+"})

# 3. 页面重定向
@app.route('/go-index')
def go_index():
    return redirect(url_for('index'))

# 4. 渲染HTML模板
@app.route('/html')
def html_res():
    return render_template('index.html', title="Flask模板页面")

python
from flask import make_response

# 设置Cookie
@app.route('/set-cookie')
def set_cookie():
    res = make_response("Cookie设置成功")
    res.set_cookie("username", "flask_user", max_age=3600)
    return res

# 获取Cookie
@app.route('/get-cookie')
def get_cookie():
    username = request.cookies.get('username')
    return f"当前登录用户：{username}"

python
from flask import session

# 必须配置密钥（session加密必备）
app.secret_key = "flask_2026_secret_key"

# 设置session
@app.route('/login')
def login():
    session['user_id'] = 1001
    session['is_login'] = True
    return "登录成功，session已存储"

# 获取session
@app.route('/user-info')
def user_info():
    user_id = session.get('user_id')
    return f"用户ID：{user_id}"

# 清空session
@app.route('/logout')
def logout():
    session.clear()
    return "退出登录成功"

python
flask_project/
├── app/
│   ├── __init__.py   # 应用工厂、初始化扩展
│   ├── main/         # 首页模块蓝图
│   ├── api/          # 接口模块蓝图
│   └── config.py     # 项目配置文件
├── static/           # 静态资源
├── templates/        # 模板文件
└── run.py            # 项目启动入口

python
from flask import Flask
from .config import Config

# 应用工厂函数
def create_app(config_class=Config):
    app = Flask(__name__)
    app.config.from_object(config_class)

    # 导入并注册蓝图
    from .main import bp as main_bp
    from .api import bp as api_bp
    app.register_blueprint(main_bp)
    app.register_blueprint(api_bp, url_prefix='/api')

    return app

python
from flask import Blueprint

bp = Blueprint('main', __name__)

from . import views

python
from . import bp

@bp.route('/')
def index():
    return "蓝图模块化首页"

python
from app import create_app

app = create_app()

if __name__ == '__main__':
    app.run()

python
pip install gunicorn

python
# 绑定端口、开启多进程
gunicorn -w 4 -b 0.0.0.0:8080 run:app