继承的Cheetah模板内函数无法访问全局变量的问题咨询

问题原因 #

Cheetah中用#set global定义的全局变量，只有在完整执行父模板到子模板的渲染流程时，才会被初始化并加入到模板的变量搜索列表（SL）中。当你单独调用子模板的某个函数（比如响应AJAX请求）时，并没有触发父模板的初始化逻辑——basepage.tmpl里的#set global $session = get_session()代码根本没被执行，自然$session不会出现在搜索列表里，导致VFFSL查找失败，抛出NameMapper.NotFound错误。

无需重复设置的解决方法 #

1. 将全局变量初始化逻辑抽为公共方法 #

在basepage.tmpl中把全局变量的初始化写成一个可复用的方法：

#def _init_global_vars()
    #set global $session = get_session()
#end def

# 在父模板的主渲染流程中调用，保证完整渲染时正常
#def main()
    $._init_global_vars()
    # 父模板其他内容...
#end def

然后在子模板的some_content()开头调用这个方法：

#def some_content()
    $._init_global_vars()
    # 函数内容...
#end def

这样既避免了代码重复，又能在单独调用函数时初始化全局变量。

2. 用模板实例属性替代全局变量 #

放弃#set global，改用Cheetah的#init块将session绑定为模板实例的属性：

# basepage.tmpl
#init
    self.session = get_session()
#end init

Cheetah的变量查找优先级是实例属性 > 搜索列表，所以不管是完整渲染还是单独调用函数，$session都会直接从模板实例的属性中获取，无需依赖渲染流程中的全局变量设置。这种方式是最可靠的，因为实例属性的生命周期和模板实例一致。

3. 外部调用时手动注入变量 #

如果是在Python代码中调用子模板的函数，可以在调用前手动将session加入模板的搜索列表：

from templates import AnActualPage

def handle_ajax_request():
    template = AnActualPage()
    # 将session添加到搜索列表
    template.searchList.append({"session": get_session()})
    return template.some_content()

这种方式不需要修改模板代码，适合在外部逻辑中统一管理变量注入。

内容的提问来源于stack exchange，提问作者Colin 't Hart