上下文

*class *jinja2.runtime.Context[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.runtime.Context "Permalink to this definition") The template context holds the variables of a template. It stores the values passed to the template and also the names the template exports. Creating instances is neither supported nor useful as it’s created automatically at various stages of the template evaluation and should not be created by hand. The context is immutable. Modifications on [parent](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.parent "jinja2.Context.parent") **must not** happen and modifications on [vars](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.vars "jinja2.Context.vars") are allowed from generated template code only. Template filters and global functions marked as [contextfunction()](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.contextfunction "jinja2.contextfunction")s get the active context passed as first argument and are allowed to access the context read-only. The template context supports read only dict operations (get, keys, values, items,iterkeys, itervalues, iteritems, __getitem__, __contains__). Additionally there is aresolve() method that doesn’t fail with a KeyError but returns an [Undefined](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Undefined "jinja2.Undefined") object for missing variables. parent[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.parent "Permalink to this definition") 一个模板查找的只读全局变量的词典。这些变量可能来自另一个 Context ，或是[Environment.globals](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Environment.globals "jinja2.Environment.globals") ，或是 [Template.globals](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Template.globals "jinja2.Template.globals") ，或指向一个由全局变量和传递到渲染函数的变 量联立的字典。它一定不能被修改。 vars[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.vars "Permalink to this definition") 模板局域变量。这个列表包含环境和来自 [parent](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.parent "jinja2.Context.parent") 范围的上下文函数 以及局域修改和从模板中导出的变量。模板会在模板求值时修改这个字典， 但过滤器和上下文函数不允许修改它。 environment[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.environment "Permalink to this definition") 加载该模板的环境 exported_vars[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.exported_vars "Permalink to this definition") 这设定了所有模板导出量的名称。名称对应的值在 [vars](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.vars "jinja2.Context.vars") 字典中。 可以用get_exported() 获取一份导出变量的拷贝字典。 name[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.name "Permalink to this definition") 拥有此上下文的模板的载入名。 blocks[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.blocks "Permalink to this definition") 模板中块当前映射的字典。字典中的键是块名称，值是注册的块的列表。每个 列表的最后一项是当前活动的块（继承链中最新的）。 eval_ctx[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Context.eval_ctx "Permalink to this definition") 当前的 [*求值上下文*](http://docs.jinkan.org/docs/jinja2/api.html#eval-context) 。 call(*callable*, **args*, ***kwargs*)[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.runtime.Context.call "Permalink to this definition") Call the callable with the arguments and keyword arguments provided but inject the active context or environment as first argument if the callable is a[contextfunction()](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.contextfunction "jinja2.contextfunction") or [environmentfunction()](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.environmentfunction "jinja2.environmentfunction"). get_all()[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.runtime.Context.get_all "Permalink to this definition") Return a copy of the complete context as dict including the exported variables. get_exported()[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.runtime.Context.get_exported "Permalink to this definition") Get a new dict with the exported variables. resolve(*key*)[](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.runtime.Context.resolve "Permalink to this definition") Looks up a variable like __getitem__ or get but returns an [Undefined](http://docs.jinkan.org/docs/jinja2/api.html#jinja2.Undefined "jinja2.Undefined") object with the name of the name looked up. 实现 Python frame 中的局域变量在函数中是不可变的，出于同样的原因，上下文是不可 变的。 Jinja2 和 Python 都不把上下文/ frame 作为变量的数据存储，而只作为 主要的数据源。 当模板访问一个模板中没有定义的变量时， Jinja2 在上下文中查找变量，此后， 这个变量被视为其是在模板中定义得一样。