Flask子模板无法引用上层目录扩展模板的问题咨询

算力阿峰

2026-7-23

Flask子模板扩展上层基础模板的路径问题

项目结构

SimpleFlask/mysite/
    flask_app.py
    /templates
        cabwill_base3.htm
        /cabwill
            /pagart
                defaultcontentA.htm

问题场景

项目计划在mysite下存放多个子站点，cabwill是其中一个子站点。子模板defaultcontentA.htm需要扩展位于templates根目录的cabwill_base3.htm，但尝试以下路径均失败：

"cabwill_base3.htm"
"./../../cabwill_base3.htm"

仅当基础模板与子模板同目录时可正常运行，但该方案不符合项目架构需求。

解决方法

Flask的模板查找逻辑基于模板根目录（即templates文件夹），而非文件系统的相对路径，需按以下方式处理：

确认模板目录配置正确
在flask_app.py中，确保Flask实例正确指向templates目录（默认配置即可，若需显式指定可参考以下代码）：
```
from flask import Flask
# 显式指定模板目录，路径相对于当前脚本所在的mysite目录
app = Flask(__name__, template_folder='templates')
```
使用模板根目录相对路径
子模板中直接使用基础模板在templates根目录下的文件名即可，无需文件系统相对路径：
```
{% extends "cabwill_base3.htm" %}
```
排查其他可能问题
- 检查文件名拼写（含大小写，Linux/macOS系统对文件名大小写敏感）
- 开启Flask调试模式（app.debug = True），避免模板缓存导致的旧内容加载
- 若仍有问题，可尝试添加根路径前缀（部分环境下需显式指定）：
```
{% extends "/cabwill_base3.htm" %}
```