ThinkPHP模板注释被删本质是构建压缩环节问题，非框架所致；HTML注释在运行时原样输出，删除发生在html-minifier等工具启用removeComments时，需通过ignoreCustomComments白名单保留。
ThinkPHP模板注释被压缩工具误删，本质不是框架问题，而是构建流程中 HTML/JS/CSS 压缩器（如 html-minifier、webpack 插件、Gulp 工具）默认移除了所有 HTML 注释（包括 <!-- 你的注释 -->）。ThinkPHP 本身不处理模板注释的保留或删除，它只负责编译和渲染。
确认是压缩环节而非 ThinkPHP 删除
ThinkPHP 模板中的 HTML 注释（<!-- ... -->）在运行时会被原样输出到响应体中，不会被框架过滤。若页面源码里看不到注释，大概率发生在部署后的静态资源构建阶段。可快速验证：
- 直接访问未压缩的开发环境 URL，查看浏览器“查看源码”，确认注释是否存在
- 检查部署产物（如 build/ 或 public/ 目录）下的 HTML 文件，是否已无注释
- 查看构建配置文件（如
vue.config.js、webpack.config.js或html-minifierCLI 参数）中是否启用了removeComments: true类似选项
HTML 压缩器白名单保留注释的方法
主流压缩工具支持通过正则或标记语法保留特定注释，关键是区分“开发调试注释”和“生产无用注释”。推荐以下通用写法：
-
html-minifier：启用
keepClosingSlash并配置ignoreCustomComments，例如：{ ignoreCustomComments: [/^!/, /^think/] }—— 这样<!--! 开发说明 -->或<!--think debug-->就会被保留 -
Webpack + html-webpack-plugin：在 plugin 配置中传入 minify 选项：
minify: { removeComments: true, ignoreCustomComments: [/^!/, /^tp/] } -
手动约定注释前缀：统一使用
<!--[if IE]>...<![endif]-->这类条件注释语法（虽已过时但多数压缩器默认保留），或更稳妥地改用<!--# ... #-->，并在压缩配置中加入/^#/白名单
ThinkPHP 模板内避免依赖 HTML 注释的替代方案
即使加了白名单，注释仍可能被 CDN、反向代理或某些 Nginx 模块清理。更可靠的做法是把关键信息转为非注释载体：
立即学习“PHP免费学习笔记（深入）”；
- 用
{php}error_log('模板加载于 ' . date('Y-m-d H:i:s'));{/php}记录日志（仅开发环境开启） - 将调试标识写入隐藏 DOM 元素：
<div id="tp-debug-info" data-env="{:app()->isDebug() ? 'dev' : 'prod'}" style="display:none"></div> - 利用 ThinkPHP 的
halt()或trace()在控制器/中间件中输出上下文，比模板注释更可控
不复杂但容易忽略：压缩工具的白名单规则对大小写敏感，且正则需完整匹配注释开头。写 /^tp-/ 就只能保留 <!--tp-version-6.3-->，而 <!-- TP-version --> 会被删掉。
