如何在Jinja2模板中匹配URL路径并渲染对应HTML文件

核心实现思路 #

把路径匹配规则和渲染逻辑分离，所有匹配规则统一放在配置映射表中，后续扩展只需要新增映射条目即可，不需要修改判断逻辑。

代码实现 #

<!-- 统一配置区：后续新增/修改规则只需要调整这里 -->
{% set SITE_PREFIX = '/siteID/' %}
{% set path_template_map = {
    # 键：去掉前缀后首尾无斜杠的路径
    # 值：对应要渲染的模板文件
    '': 'file1.html',
    'abcde': 'file2.html',
    'abcde/uvwxyz': 'file3.html'
} %}
<!-- 公共逻辑区：不需要修改 -->
{% if request.path.startswith(SITE_PREFIX) %}
    {# 统一格式化路径，消除首尾斜杠带来的匹配误差 #}
    {% set processed_path = request.path[len(SITE_PREFIX):].strip('/') %}
    {# 匹配路径，未匹配到则使用默认模板file1.html #}
    {% include path_template_map.get(processed_path, 'file1.html') %}
{% else %}
    {% include "file1.html" %}
{% endif %}

方案优势 #

• 没有硬编码的路径长度限制，后续如果站点前缀/siteID/有变动，只需要修改SITE_PREFIX一个变量即可
• 规则和逻辑完全分离，新增路径匹配规则只需要在path_template_map中加一行键值对，不需要调整判断逻辑
• 自动处理路径首尾斜杠问题，不会出现因路径多写/少写结尾斜杠导致匹配失败的问题

复杂场景扩展（支持通配符/动态路径匹配） #

如果后续需要支持/siteID/abcde/*这类通配符匹配，或者带参数的动态路径匹配，可以改用规则列表的实现方式：

{% set SITE_PREFIX = '/siteID/' %}
<!-- 规则按优先级从上到下排列，匹配到第一个就终止 -->
{% set match_rules = [
    (lambda p: p == '', 'file1.html'),
    (lambda p: p == 'abcde', 'file2.html'),
    (lambda p: p.startswith('abcde/uvwxyz'), 'file3.html'),
    (lambda p: p.startswith('user/'), 'user_profile.html'),
] %}

{% set processed_path = request.path[len(SITE_PREFIX):].strip('/') %}
{% set target_template = 'file1.html' %}
{% for rule, template in match_rules %}
    {% if rule(processed_path) %}
        {% set target_template = template %}
        {% break %}
    {% endif %}
{% endfor %}
{% include target_template %}

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