Jinja2引用搜索路径外文件失败问题（关联PrefixLoader/ChoiceLoader）

嘿，我来帮你搞定这个Jinja2跨目录引用的麻烦！

首先得说清楚为啥你用../folder_bbb/subfile.txt会失败：Jinja2的FileSystemLoader默认是严格限制在你指定的searchpath（也就是template_folder）范围内的，出于安全考虑，它不允许模板跳出这个目录去访问其他地方的文件，所以../这种向上跳转的相对路径会被直接拦截。

接下来给你几个靠谱的解决办法，按推荐程度排序：

方法1：用ChoiceLoader加载多个目录 #

这种方法最简单，直接把你需要引用的所有目录都加入Jinja2的搜索路径，这样你在模板里就可以直接写目标文件的路径，不用再用../跳转了。

示例代码：

from jinja2 import Environment, FileSystemLoader, ChoiceLoader

# 把需要用到的模板目录都列出来
template_loaders = [
    FileSystemLoader("template_folder"),  # 原有的模板目录
    FileSystemLoader("folder_bbb"),       # 需要引用的folder_bbb目录
    FileSystemLoader("folder_aaa")        # 顺便把folder_aaa也加上，引用更方便
]

# 用ChoiceLoader组合这些加载器
env = Environment(loader=ChoiceLoader(template_loaders))

之后在template_file里引用的时候，直接写：

{% include "subfile.txt" %}  <!-- 如果多个目录有重名文件，会按加载器顺序优先匹配第一个找到的 -->
{% include "folder_bbb/subfile.txt" %}  <!-- 或者写全路径避免重名冲突 -->

方法2：用PrefixLoader给目录加前缀 #

如果你的目录比较多，担心重名文件冲突，用PrefixLoader给每个目录加个前缀，引用的时候通过前缀区分，逻辑更清晰。

示例代码：

from jinja2 import Environment, FileSystemLoader, PrefixLoader

# 给每个目录分配一个前缀，键是前缀名，值是对应的FileSystemLoader
prefix_loaders = {
    "tpl": FileSystemLoader("template_folder"),
    "bbb": FileSystemLoader("folder_bbb"),
    "aaa": FileSystemLoader("folder_aaa")
}

env = Environment(loader=PrefixLoader(prefix_loaders))

然后在模板里引用的时候，要加上前缀：

{% include "aaa/subfile.txt" %}  <!-- 引用folder_aaa里的文件 -->
{% include "bbb/subfile.txt" %}  <!-- 引用folder_bbb里的文件 -->

不推荐的方法：把搜索路径设为上层目录 #

虽然可以直接把searchpath设为项目根目录（也就是.），这样../就能用了，但这种做法会把所有项目文件都暴露给模板引擎，存在安全风险（比如模板可能意外访问到敏感配置文件），所以除非你完全清楚风险，否则不建议这么做：

# 不推荐！
env = Environment(loader=FileSystemLoader("."))

总结一下，优先选ChoiceLoader或者PrefixLoader，既安全又符合Jinja2的设计规范，能完美解决你的跨目录引用问题。

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