ThinkPHP模板注释仅作说明，不参与解析或代码生成；合法写法为{//单行}和{/*多行*/}，不被任何标准工具识别，元信息应置于PHPDoc或配置中。
ThinkPHP 的模板注释本身不参与代码生成，也不被框架解析执行——它只在模板文件中起说明作用，和 PHP 代码层的注释（如 PHPDoc）或数据库字段 COMMENT 完全无关。所谓“在代码生成工具中规范”，其实是常见误解：目前主流 ThinkPHP 生态中，并没有官方或广泛采用的、能基于模板注释自动生成控制器、模型或 API 文档的工具。
模板注释只有两种合法写法
ThinkPHP 模板引擎（ThinkTemplate）支持且仅支持以下语法：
-
单行注释：
{// 这是模板单行注释}，从{//开始到行尾或}结束，中间内容完全不输出、不解析 -
多行注释：
{/* 这是模板多行注释，可以跨行 */}，支持换行，但不能嵌套
注意：这些不是 PHP 注释，不能写在 PHP 文件里；也不能混用 HTML 注释<!-- -->来替代，否则会被原样输出到页面源码中。
为什么模板注释无法用于代码生成
原因很直接：
立即学习“PHP免费学习笔记（深入）”；
- 模板注释在模板编译阶段就被直接剥离，不会进入 AST 或反射信息
- ThinkPHP 不提供模板注释的解析 API，也没有预留钩子供第三方工具提取
- 当前所有代码生成工具（如 think-swoole、think-orm-gen、Swagger 集成插件等）都只读取 PHPDoc（
/** */）、PHP 属性（#[Route]）、配置数组或数据库 schema，不扫描 .html 或 .tpl 模板文件 - 即使你写
{// @api /user/list GET}，也不会被任何标准工具识别——它只是被忽略的字符串
想让模板具备“可生成”能力？得换思路
真正可行的方案是把元信息移到框架能读取的位置：
-
接口定义写在控制器方法的 PHPDoc 中，例如：
/*** @api /user/list* @method GET*/public function list() { ... }—— 这类注释可被 Swagger、phpstan、IDE 等识别 -
模板复用逻辑用 {include} + 显式传参表达，比如
{include file="/widget/table" title="用户列表" columns=$tableCols}，参数结构清晰，便于前端工程化工具做静态分析 -
需要文档化模板结构？手动维护 JSON Schema 或 YAML 描述文件，而非依赖注释。例如定义
widget/table.schema.yml说明该模板接收哪些变量、类型和默认值
常见误用与排查建议
如果你发现某工具声称“支持从模板注释生成代码”，大概率是：
- 定制开发的私有工具，未开源，且强依赖特定注释格式（如要求
{// GEN: model=User}），不可迁移 - 混淆了“模板注释”和“PHP 类/方法注释”，实际扫描的是控制器或模型文件
- 把模板里的
{__STATIC__}等系统变量误认为是可解析的元数据
验证方式很简单：删掉所有模板注释，看生成结果是否变化——如果不变，就说明它根本没读。
