Flask上下文处理器：全局变量与模板复用

什么是上下文处理器？¶

上下文处理器是Flask提供的一个装饰器（@app.context_processor），通过定义一个函数并返回一个字典，就能让字典中的键值对自动成为所有模板的可用变量。这些变量会在每次渲染模板时被注入到模板的上下文中，相当于“全局”可用，但仅针对当前请求的模板。

基本用法：快速注入共享变量¶

要使用上下文处理器，只需在Flask应用中用@app.context_processor装饰一个函数，函数返回的字典键是模板中变量的名称，值是变量的具体内容。

示例1：显示当前时间¶

假设我们想在所有模板中显示当前时间，使用上下文处理器只需这样写：

from flask import Flask, render_template
from datetime import datetime

app = Flask(__name__)

# 定义上下文处理器，返回当前时间
@app.context_processor
def inject_current_time():
    current_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    return {'current_time': current_time}  # 字典键名即模板变量名

@app.route('/')
def index():
    return render_template('index.html')  # 无需传递current_time变量

@app.route('/about')
def about():
    return render_template('about.html')  # 无需传递current_time变量

此时，在任何模板（如index.html或about.html）中，都可以直接使用{{ current_time }}显示当前时间：

<!-- index.html 或 about.html 中 -->
<p>当前时间：{{ current_time }}</p>

模板复用：共享导航菜单¶

上下文处理器的核心价值之一是模板复用。比如导航菜单、页脚信息等在多个页面都需要显示的内容，用上下文处理器统一管理，修改一处即可应用到所有模板。

示例2：共享导航菜单¶

定义一个导航菜单列表，通过上下文处理器返回，所有模板都能直接使用：

@app.context_processor
def inject_navigation():
    nav_items = [
        {'name': '首页', 'url': '/'},
        {'name': '关于', 'url': '/about'},
        {'name': '联系', 'url': '/contact'},
        {'name': '登录', 'url': '/login'}
    ]
    return {'nav_items': nav_items}  # 模板中用nav_items变量

@app.route('/')
def index():
    return render_template('index.html')

@app.route('/contact')
def contact():
    return render_template('contact.html')

在模板中循环渲染导航菜单：

<!-- base.html 或 index.html 中 -->
<nav>
    <ul>
        {% for item in nav_items %}
            <li><a href="{{ item.url }}">{{ item.name }}</a></li>
        {% endfor %}
    </ul>
</nav>

这样，无论访问哪个页面，导航菜单都会自动显示，无需在每个视图函数中重复传递nav_items。

动态数据：当前用户信息¶

上下文处理器的变量可以是动态的（比如根据用户登录状态变化）。例如，显示当前登录用户的信息：

@app.context_processor
def inject_user_info():
    # 假设从session中获取用户信息（实际项目需结合用户认证）
    # 这里用模拟数据，登录状态为True时返回用户信息，否则返回None
    user = {'name': '小明', 'is_logged_in': True} if True else None
    return {'current_user': user}

@app.route('/profile')
def profile():
    return render_template('profile.html')

在模板中根据用户信息显示不同内容：

{% if current_user %}
    <h1>欢迎回来，{{ current_user.name }}！</h1>
    <a href="/logout">退出登录</a>
{% else %}
    <p>请先登录</p>
    <a href="/login">登录</a>
{% endif %}

不用上下文处理器？对比更清晰¶

如果不用上下文处理器，每个视图函数都需要手动传递共享变量。例如，显示当前时间和导航菜单，视图函数需要这样写：

@app.route('/')
def index():
    current_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    nav_items = [{'name': '首页', 'url': '/'}, ...]
    return render_template('index.html', current_time=current_time, nav_items=nav_items)

@app.route('/about')
def about():
    current_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S')
    nav_items = [{'name': '首页', 'url': '/'}, ...]
    return render_template('about.html', current_time=current_time, nav_items=nav_items)

而用上下文处理器后，视图函数只需返回模板名称，变量自动注入，代码更简洁：

@app.route('/')
def index():
    return render_template('index.html')  # 无需传递变量

@app.route('/about')
def about():
    return render_template('about.html')  # 无需传递变量

总结¶

上下文处理器是Flask中一个高效的模板复用工具，核心作用是自动注入共享变量到所有模板，避免重复代码，让多个模板可以共享导航、用户信息、页脚等内容。它的优势在于：
- 代码简洁：无需在每个视图函数中重复传递变量；
- 动态更新：变量可随请求动态变化（如当前时间、用户登录状态）；
- 维护性高：修改共享内容只需改上下文处理器，所有模板自动生效。

下次开发Flask项目时，如果遇到多个模板需要共享数据，不妨试试上下文处理器，让代码更优雅、更易维护！