Python Flask：如何通过非路由函数构建模板并解决模板缺失问题

错误原因 #

你在sidenav.py中使用了BaseLoader，这是Jinja2的基础加载器，它不具备从文件系统读取模板文件的能力，所以无论你把sidenav.py放在哪个位置，都会找不到sidenav.html模板。

修正方案：正确加载模板 #

方案1：复用Flask已配置的Jinja环境 #

Flask启动时已经自动配置好了模板路径（默认是项目根目录下的templates文件夹），直接复用这个环境即可，无需手动初始化Environment：

修改sidenav.py：

## sidenav.py
from flask import current_app

def build():
    # 直接使用Flask已初始化的Jinja环境加载模板
    template = current_app.jinja_env.get_template('sidenav.html')
    # 若需要预先渲染导航内容，可调用render()
    # rendered_sidenav = template.render()

修改__init__.py，确保调用build时处于Flask应用上下文内：

import os
from flask import Flask

def create_app(test_config=None):
    app = Flask(__name__)
    
    # 确保在应用上下文内执行build
    with app.app_context():
        from .layout.sidenav import build
        build()
    
    return app

方案2：手动指定文件加载器（不推荐，除非特殊需求） #

如果一定要手动初始化Environment，需要使用FileSystemLoader并指定正确的模板文件夹路径：

## sidenav.py
import os
from jinja2 import Environment, FileSystemLoader

def build():
    # 根据sidenav.py的位置，计算模板文件夹的绝对路径
    # 假设templates文件夹在项目根目录，sidenav.py在layout子文件夹下
    template_dir = os.path.join(
        os.path.dirname(os.path.abspath(__file__)),
        '../../templates'  # 调整相对路径匹配你的项目结构
    )
    env = Environment(loader=FileSystemLoader(template_dir))
    template = env.get_template('sidenav.html')

实现无需路由传参的侧边导航 #

要让侧边导航无需每个路由都传递参数，可以使用Flask的上下文处理器，将导航所需数据全局注入到所有模板中：

在__init__.py中添加上下文处理器：

def create_app(test_config=None):
    app = Flask(__name__)

    # 全局注入侧边导航数据
    @app.context_processor
    def inject_sidenav_data():
        # 这里可以从数据库/配置文件读取菜单数据
        sidenav_menus = [
            {'name': '首页', 'url': '/'},
            {'name': '文章列表', 'url': '/posts'},
            {'name': '关于我们', 'url': '/about'}
        ]
        return {'sidenav_menus': sidenav_menus}

    with app.app_context():
        from .layout.sidenav import build
        build()
    
    return app

然后在sidenav.html中直接使用全局变量：

<!-- templates/sidenav.html -->
<nav class="sidebar">
    <ul>
        {% for menu in sidenav_menus %}
            <li><a href="{{ menu.url }}">{{ menu.name }}</a></li>
        {% endfor %}
    </ul>
</nav>

这样base.html中{% include 'sidenav.html' %}就能直接渲染出导航，无需在任何路由中传递sidenav_menus参数。

内容的提问来源于stack exchange，提问作者dizzystar