thinkphp模板注释不被php代码度量工具识别，因其属于模板引擎处理的文本资源，编译时即被剥离，仅php文件中的phpdoc注释才参与静态分析与文档生成。
ThinkPHP 模板注释本身不会被主流代码度量工具（如 PHPMD、PHP_CodeSniffer、Psalm、PHPStan）识别或统计。原因很直接：这些工具只分析 PHP 源文件（.php），而模板文件（.html、.tpl 等）是 ThinkPHP 模板引擎（ThinkTemplate）处理的文本资源，不属于 PHP 语法范畴，不参与 PHP 解析和 AST 构建。
模板注释不计入代码度量的原因
模板注释（如 {// 注释} 或 {/* 多行注释 */}）在模板编译阶段就被完全剥离——生成的缓存文件（位于 runtime/cache/ 下的 .php 文件）里不含任何模板注释内容。度量工具扫描的是最终可执行的 PHP 代码或原始 .php 源码，自然看不到、也无法解析它们。
- PHPMD / PHP_CodeSniffer：仅扫描 .php 文件，忽略 .html/.tpl
- PHPStan / Psalm：依赖 PHP 类型反射和 AST，模板文件无 PHP 结构
- 代码行数（LOC）统计工具（如 cloc）：若手动纳入 .html 文件，会把模板注释算作“注释行”，但这属于文件级文本统计，与 PHP 逻辑无关，也不反映业务逻辑复杂度
想让注释参与质量管控？走 PHP 层路线
真正能被度量工具捕获、用于静态分析和文档生成的，只有 PHPDoc 风格的文档注释（/** ... */），且必须出现在 PHP 文件中：
- 控制器、模型、验证器等类/方法前的 PHPDoc，可被 PHPStan 检查参数类型、被 phpDocumentor 生成 API 文档
- 在
app/common.php或服务类中为公共函数添加完整 PHPDoc，支持 IDE 补全和类型推导 - 避免在模板里写逻辑说明——把接口契约、字段含义、业务规则等关键信息沉淀到 PHP 层注释或常量/配置中
如果硬要统计模板注释（仅限管理用途）
可用轻量脚本辅助人工审查，例如用 cloc 单独统计模板目录：
cloc app/view/ --include-lang="HTML" --by-file
它会把 {//...} 和 {/*...*/} 当作 HTML 注释行计入 Comment lines 列，但请注意：
- 这不能替代代码质量分析，仅反映“写了多少模板说明”
- 模板注释无语义约束，错写也不会报错（比如
{// param $id}不会被校验） - 建议将重点放在 PHP 层注释规范上，模板注释仅用于临时标注布局结构或待办事项
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
