金贾2

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

环境

创建一次jinja2.Environment(loader=..., autoescape=...)并重复使用它。对基于文件的模板使用 FileSystemLoader,对已安装的软件包使用 PackageLoader。为 HTML 模板启用autoescape=True以防止 XSS。

模板

使用{{ variable }}用于输出,{% if/for/block %}用于控制流。使用模板继承({% extends 'base.html' %})进行布局重用。定义可重用转换的自定义过滤器。

安全性

渲染 HTML 时始终启用 autoescape=True。对于不受信任的模板使用SandboxedEnvironment。切勿将用户输入呈现为模板代码——仅呈现为模板数据。当自动转义关闭时显式使用 |e 过滤器。

陷阱

不要直接使用Template(string)——它会绕过环境的加载器和设置。注意未定义的变量错误——在开发过程中使用undefined=StrictUndefined。避免模​​板中的复杂逻辑——让它们专注于演示。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@microsoft · NOASSERTION
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Skill: Jinja2

Best practices for template rendering with Jinja2 including environments, filters, autoescaping, and security.

## When to Use

Apply this skill when rendering templates with Jinja2 — HTML pages, emails, configuration files, and code generation.

## Environment

-   Create a `jinja2.Environment(loader=..., autoescape=...)` once and reuse it.
-   Use `FileSystemLoader` for file-based templates, `PackageLoader` for installed packages.
-   Enable `autoescape=True` for HTML templates to prevent XSS.

## Templates

-   Use `{{ variable }}` for output, `{% if/for/block %}` for control flow.
-   Use template inheritance (`{% extends 'base.html' %}`) for layout reuse.
-   Define custom filters for reusable transformations.

## Security

-   **Always** enable `autoescape=True` when rendering HTML.
-   Use `SandboxedEnvironment` for untrusted templates.
-   Never render user input as template code — only as template data.
-   Use `|e` filter explicitly when autoescape is off.

## Pitfalls

-   Don't use `Template(string)` directly — it bypasses the environment's loader and settings.
-   Watch for undefined variable errors — use `undefined=StrictUndefined` during development.
-   Avoid complex logic in templates — keep them focused on presentation.

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。