ThinkPHP模板注释（如{//...}、{/.../}）是模板引擎专有语法，非PHP语言层注释，phpCB等工具因无模板语义解析能力，会误判结构、破坏格式；应通过排除模板路径或禁用相关美化选项来规避风险。
ThinkPHP 模板注释（如 {// 单行注释}、{/* 多行注释 */}）是模板引擎专有语法，不属于 PHP 语言层注释，因此绝大多数 PHP 代码美化工具（如 phpCB、PHP_CodeSniffer、php-cs-fixer）默认不识别也不处理它们。强行格式化可能破坏模板结构，甚至导致解析错误。
为什么 phpCB 等工具会“乱动”模板注释
phpCB 默认把 { 和 } 当作 PHP 代码块分隔符，遇到 {// ...} 时容易误判为非法语法或未闭合结构。它没有模板语义解析能力，只按字符规则缩进、换行、加空格——结果常是：
- 把
{// 注释}拆成多行，变成{//换行再注释} - 在
{前后加空格，变成{ //或{ //，而 ThinkPHP 模板引擎只认紧贴的{// - 对
{/* ... */}中的*做对齐处理，破坏注释边界
安全配置 phpCB 避免破坏模板注释
若必须用 phpCB 统一项目风格，需关闭所有影响花括号和注释符号的选项：
- 去掉
--space-before-start-angle-bracket（避免给{前加空格） - 去掉
--space-after-end-angle-bracket（避免给}后加空格） - 禁用
--change-shell-comment-to-double-slashes-comment（该选项会把#转成//，与模板注释无关且易冲突） - 不启用
--comment-rendering-style PEAR类注释美化参数——模板注释不走 PHPDoc 流程
推荐最小安全参数组合：
立即学习“PHP免费学习笔记（深入）”；
--space-after-if --space-after-switch --space-after-while --optimize-eol --glue-amperscore --indent-with-tab "$(FilePath)"更稳妥的做法：分离处理 PHP 与模板文件
真正健壮的方案不是硬调 phpCB，而是让代码美化工具跳过 .html 或 .tpl 模板文件：
- 在 phpCB 命令中显式排除模板路径：
phpcb --exclude=app/view/ --exclude=public/static/ *.php - 使用支持文件类型过滤的现代工具（如
php-cs-fixer），在.php-cs-fixer.php中配置：
$finder = PhpCsFixer\Finder::create()<br> ->in(['app', 'config', 'controller', 'model'])<br> ->name('*.php');这样模板文件完全不受干扰，PHP 逻辑层仍可享受统一风格。
IDE 内置美化对模板注释的影响
PhpStorm 等 IDE 的“Reformat Code”默认也不会处理 {//...}，但需注意：
- 确保模板文件被识别为 “ThinkPHP Template” 或 “HTML” 类型，而非纯 “Text” —— 否则缩进逻辑失效
- 在
Settings → Editor → Code Style → HTML → Other中，取消勾选 “Enable formatting for PHP code in HTML files”，防止混排时误操作 - 不要开启 “Wrap text at right margin” 对模板注释区域生效，否则长注释会被折行
