lint:twig 命令仅校验 twig 模板语法合法性，如标签配对、过滤器拼写等，不检查变量定义、运行时错误或继承路径存在性；支持指定文件或目录扫描，但需显式声明自定义后缀。
lint:twig 命令能查什么错误
php bin/console lint:twig 本质是静态语法扫描，不执行模板、不加载上下文变量，只校验 Twig 语法结构是否合法。它能发现 {% if user.name %} 漏写结尾 %}、{% for item in items %} 缺少 {% endfor %}、过滤器拼写错误（比如写成 |translat）等硬性语法问题。但不会报 {{ user.email }} 中 user 为空或未定义——那属于运行时行为，得靠 strict_variables: true 配合触发。
怎么用 lint:twig 扫描指定文件或目录
最常用的是两种调用方式：
-
php bin/console lint:twig templates/：递归检查templates/下所有.html.twig和.twig文件 -
php bin/console lint:twig templates/home/index.html.twig：只检查单个文件，适合改完一个模板后快速验证
注意：lint:twig 默认只认 .html.twig 和 .twig 后缀；如果你用了 .email.twig 这类自定义后缀，命令会跳过——得加 --format=html.twig,email.twig 参数显式声明。
常见误报和漏报场景
这个命令不是万能的，容易让人误判：
- 嵌套太深的
{% include %}不会报错，但实际运行可能因路径不存在而崩溃——debug:twig @App/partial.html.twig才能确认物理路径是否存在 - 宏（
{% macro %}）里调用未定义变量，lint:twig不检查，只有运行时开启strict_variables才暴露 - 使用了自定义 Twig 扩展函数（比如
my_custom_filter()），只要函数名拼对了，lint:twig就放行，哪怕该扩展根本没注册 - Windows 下路径含中文或空格时，命令可能直接抛出
file_get_contents(): failed to open stream—— 先用dir /x看短路径名，或把项目移到纯英文路径下再试
为什么 lint 通过了，页面还是白屏？
因为 lint:twig 只管语法，不管逻辑和环境：
- 模板里写了
{{ app.user.username|trans }}，但translation组件没启用或语言包缺失 → 页面空白或输出原文，lint不报 - 用了
{% set data = some_service.getData() %}，但some_service在当前环境不可用 → 运行时报ServiceNotFoundException，lint不管 - 模板继承链中父模板被删了，比如
{% extends 'base.html.twig' %}但base.html.twig不存在 →lint不验证继承目标是否存在，得靠debug:twig @App/base.html.twig
真正可靠的闭环是：先 lint:twig 过语法，再开 debug: true + strict_variables: true 跑一遍真实请求，最后看 WebProfiler 的 Templates 标签页确认渲染流是否完整。
