金贾2
- 作者仓库星标 2,412
- 许可证 NOASSERTION
- 作者仓库 debugpy
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @microsoft · NOASSERTION
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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.
章节与文件索引
按说明文件中的顺序排列。
环境
模板
安全性
陷阱
文件/命令 -> jinja2.Environment(loader=..., autoescape=...) · FileSystemLoader · PackageLoader · autoescape=True · {{ variable }} · {% if/for/block %} · {% extends 'base.html' %} · SandboxedEnvironment
内容校验值 -> 3ace875bcc67
当前原文的自动摘译,尚未人工审校。
环境
创建一次
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。避免模板中的复杂逻辑——让它们专注于演示。