ThinkPHP 5.1 模板注释（如{% comment %}{% endcomment %}、{// }）不被PHP解析器识别，主流静态分析工具（PHPStan、Psalm、PHP_CodeSniffer）默认忽略.html/.tpl文件，因其无PHP语法结构且编译时即被剥离。
ThinkPHP 5.1 的模板注释（如 {% raw %}<!--{php}echo 'test';{/php}-->{% endraw %} 或 {% raw %}<!--{if $a}xxx{/if}-->{% endraw %}）本身是运行时解析的伪注释，**不被 PHP 解析器识别，也不参与 PHP 语法分析**。因此，主流静态分析工具（如 PHPStan、Psalm、PHP_CodeSniffer）默认完全忽略模板文件（.html 或 .tpl），更不会解析其中的 ThinkPHP 模板语法。
确认模板文件是否纳入扫描范围
多数静态分析工具默认只处理 .php 文件。若你的模板存放在 view/ 目录下且后缀为 .html，它们根本不会被读取。
- 检查 PHPStan 配置（
phpstan.neon）中paths:是否包含view/；若包含，需额外配置fileExtensions:加入html - Psalm 默认仅扫描
.php，需在psalm.xml中显式添加<file name="view/**/*.html"/>并启用自定义解析器（但 Psalm 不原生支持 TP 模板语法） - PHP_CodeSniffer 通过
--extensions=php,html可读取 HTML 文件，但其标准 sniff 无法理解{:name}或{if $x}等语法，会报大量“语法错误”
避免误报：推荐排除模板目录
对模板文件做 PHP 级别的静态分析既无意义又易出错。最稳妥做法是主动排除：
- PHPStan：在
phpstan.neon中加入excludePaths:列出view/** - Psalm：在
psalm.xml中用<ignoreFiles><directory name="view"/></ignoreFiles> - PHP_CodeSniffer：运行时加
--ignore=view/，或在phpcs.xml中配置<arg name="ignore" value="view/*"/>
如确需检查模板逻辑，应换用专用方式
静态分析工具不是为模板语法设计的。替代方案更实际：
立即学习“PHP免费学习笔记（深入）”；
- 启用 ThinkPHP 的模板调试模式：
'template' => ['debug' => true]，运行时可捕获未定义变量、语法拼写错误等 - 在控制器中对传入模板的数据做类型断言（如用 PHPDoc 注解
@var string $title），让 IDE 和 PHPStan 能校验数据层 - 对关键模板片段编写单元测试（使用
think\template\driver\File手动渲染并断言输出）
模板注释和标签属于视图层 DSL，不在 PHP 语法树内。强行让 PHP 静态分析工具处理它，就像让 Word 检查 Excel 公式——方向错了。聚焦于控制器与模型的强类型保障，才是 ThinkPHP 5.1 项目可持续维护的关键。
