模板注释不参与运行、不被代码审查工具识别，仅用于人工协作；审查应聚焦php文件中的phpdoc注释，模板注释需具体、及时清理且避免误导。
ThinkPHP模板注释本身不参与运行、不输出HTML、也不被任何主流代码审查工具识别或分析。它只是模板文件中供开发者临时阅读的视觉标记，不是代码契约，更不构成可审查的逻辑依据。因此，“在代码审查工具中使用”是个常见误解——工具根本看不到它。
模板注释与代码审查工具完全无关
PHP代码审查工具（如 PHPStan、Psalm、PHP_CodeSniffer）只扫描 .php 文件，依赖 PHP 语法树和类型系统。而模板文件（.html/.tpl）属于纯文本资源，其注释 `{// }` 和 `{/* */}` 在模板编译阶段就被彻底剥离，不会进入缓存 PHP 文件，也不会出现在 AST 中。
- Git blame 可显示谁写了这行注释，但无法判断它是“临时禁用”还是“说明意图”
- IDE 可能高亮或折叠 `{/* */}` 区块，但这只是文本层面的辅助，不触发语义检查
- 没有审查工具会把 `{// @todo}` 当作待办事项提取，也不会因注释缺失而报 warning
真正该放进审查范围的是 PHP 层注释
代码审查应聚焦在控制器、模型、验证器等 PHP 文件中的 PHPDoc 注释上，这些才是工具可读、可校验、可生成文档的“有效注释”：
- 控制器方法前的 `/** @api /user/info @method GET */` 可被 Swagger 或静态分析识别
- 模型属性注释 `/** @var int 用户状态：0-禁用,1-启用 */ public $status;` 支持 IDE 补全和类型推导
- 验证规则旁注明业务含义，如 `/** 需校验手机号格式且归属实名认证用户 */`
模板注释仅用于人工协作场景
它存在的唯一合理价值，是帮团队成员快速理解模板结构和上下文，前提是写得具体、及时清理：
- 写 `{// 用户头像+昵称+等级徽章渲染区块}`，别写 `{// 这里显示用户}`
- 临时关闭某模块时，加时间戳和原因：`{// @temp disabled for A/B test, remove after 2026-07-15}`
- 继承布局中，在 `{block name="sidebar"}{/block}` 前后加注释，标明作用域边界
- 发现注释描述与实际代码不符，应立刻修正代码或删除注释——过时注释比没注释更危险
审查时对模板注释的处理建议
在走查 PR 或 CR 时，可快速扫视模板注释，但重点不在“有没有”，而在“是否误导”：
- 看到 `{// 该功能已上线}`，确认对应逻辑确实已启用且无条件屏蔽
- 发现 `{// @deprecated}` 注释，检查是否已同步移除相关模板代码或替换成新组件
- 大量 `{// TODO}` 堆积，提醒作者转入 issue 跟踪，避免注释债累积
- 注释中出现调试信息（如 `dump($data)` 的残留）、敏感字段名或硬编码值，必须清除
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
