smarty是纯php编写的轻量模板引擎，通过assign()和display()分离逻辑与html，需手动配置templates_c等路径并确保web服务器写权限，变量名严格区分大小写且须显式赋值。
PHP模板引擎不是“让HTML变动态”的魔法工具，而是把PHP逻辑和HTML结构物理隔开的一道墙。Smarty是其中最老牌、部署最轻量的实现——它不依赖扩展，纯PHP写成，但必须手动配路径、设权限、走assign()和display()两步才能出HTML。
Smarty初始化失败：templates_c目录不可写是最常见原因
报错如Smarty: unable to write to $compile_dir或页面空白，90%是权限或路径配置错。Smarty不会自动创建templates_c目录，也不会提示你“该目录不存在”，它只默默失败。
-
templates_c和cache必须是真实存在的空目录，且Web服务器进程（如www-data、apache、nginx）有写权限 - Linux/macOS下用
chmod 755 templates_c cache不够，得确认属主：比如Apache运行用户是www-data，就得chown www-data:www-data templates_c - Windows IIS下要右键目录→属性→安全→添加IUSR用户并勾选“写入”
- 路径必须用相对或绝对路径，不能用
__DIR__拼接后漏掉斜杠，比如$smarty->setCompileDir(__DIR__ . '/templates_c')比$smarty->setCompileDir('templates_c/')更稳
display()没输出HTML？检查assign()是否漏调或变量名大小写不一致
Smarty对变量名完全敏感，$smarty->assign('User', '张三')后，在模板里写{$user}就是空的。它也不接受数组键名带空格或特殊符号，assign('user name', ...)会导致解析失败。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 所有传给模板的数据必须显式调用
assign()，不能靠extract()或全局变量 - 变量名只允许字母、数字、下划线，且必须以字母或下划线开头
- 调试时打开
$smarty->debugging = true，页面右下角会弹出变量面板，能直接看到哪些变量已注入、值是什么 - 如果用了
fetch()而非display()，注意它返回字符串而非直接输出，得自己echo或存文件
渲染出的HTML里中文乱码或{if}语法不解析？模板文件编码和解析开关要对齐
乱码通常不是Smarty的问题，而是.tpl文件保存成了GBK或带BOM的UTF-8。Smarty默认按UTF-8读取，一旦BOM存在，{前面多出几个不可见字节，整个标签就失效了。
- 用VS Code、Sublime Text等编辑器另存为“UTF-8 without BOM”格式
- 禁用
$smarty->auto_literal = false（默认true），否则{literal}{/literal}外的花括号会被误判为Smarty指令 - 若模板里要原样输出
{，必须包在{literal}...{/literal}里，不然会被当成未闭合标签报错 - PHP端确保
header('Content-Type: text/html; charset=utf-8');已设置，否则浏览器可能按ISO-8859-1解析
Smarty本身不处理数据库或路由，它只干一件事：把PHP数组变成HTML字符串。真正容易被忽略的是编译缓存机制——首次访问会生成.php文件在templates_c里，后续请求直接执行这个PHP文件。这意味着改了.tpl但没清缓存，看到的还是旧内容；而删了templates_c又没重置权限，下次访问就卡死。这层“自动编译+缓存”的耦合，恰恰是它快，也是它难调的地方。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
