Python环境下Jinja2模板从上级目录导入宏失败的问题求助

我完全理解你的处境——项目结构没法调整，但又必须从上级目录导入宏文件。其实问题出在Jinja2的模板加载机制上：它的路径解析是基于模板根目录的，而非普通文件系统那样用../回退到上级文件夹。下面给你两个可行的解决办法：

方法1：使用基于根目录的绝对导入路径 #

既然你的模板根目录是templates文件夹，直接用根目录起始的路径导入即可，不用管当前模板在哪个子文件夹里。比如在template1.jinja2里，把导入语句改成：

{% import "macros.jinja2" as macros %}

这样Jinja2会直接从模板根目录（也就是templates文件夹）定位macros.jinja2，不管当前模板在subfolder还是其他子目录，都能正常导入。

方法2：扩展模板加载器的搜索路径（若有权限修改后端代码） #

如果你能修改Python代码里的Jinja2环境配置，可以给模板加载器添加额外的搜索路径。比如用FileSystemLoader时，把需要的目录都加入搜索列表：

from jinja2 import Environment, FileSystemLoader

# 同时将templates根目录和subfolder目录加入搜索路径
loader = FileSystemLoader(['templates', 'templates/subfolder'])
env = Environment(loader=loader)

不过这个方法需要你能调整后端配置，如果公司政策不允许改代码，优先用方法1就好。

为什么../导入会失败？ #

Jinja2的模板加载器默认不解析../这类文件系统风格的相对路径，这是出于安全考虑——防止访问模板目录外的文件。所以即便文件系统中../macros.jinja2确实存在，Jinja也不会识别这个路径。

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