XAMPP下Smarty启动失败最常见原因是templates_c目录不存在或无写权限，导致编译失败；其次为php.ini中include_path未正确指向libs目录，以及Webman等常驻框架下多worker并发写冲突。
templates_c目录不存在或无写权限导致Uncaught exception 'SmartyException' with message 'the $compile_dir ... does not exist'
这是XAMPP下Smarty启动失败最常见报错，根本原因不是Smarty没装好，而是Apache进程无法在templates_c目录里创建编译文件。Windows下Apache默认以SYSTEM账户运行，而你手动新建的templates_c目录往往只继承了当前登录用户的权限。
实操建议：
- 必须手动创建
templates_c（以及cache）目录，不能靠Smarty自动建——它只在有写权限时才尝试建，否则直接抛异常 - 右键目录 → “属性” → “安全” → 编辑 → 添加
SYSTEM用户，并勾选“完全控制”；如果用的是XAMPP控制面板启动的Apache，也需确认Administrators和你的当前登录用户有写入权 - 路径必须是绝对路径或Web可解析的相对路径：比如
$smarty->setCompileDir(__DIR__ . '/templates_c/');比'./templates_c/'更可靠，避免因脚本调用层级不同导致路径错位
php.ini中include_path指向错误导致Unable to load template file
报这个错，90%是因为include_path没对准Smarty.class.php真实位置。PHP不会自动钻进子目录找类文件，它只在include_path列出的每个路径下直接搜Smarty.class.php。
实操建议：
- 确认
Smarty.class.php实际路径，例如：D:/xampp/htdocs/myproject/smarty/libs/Smarty.class.php - 在
php.ini里设置：include_path = ".;D:/xampp/htdocs/myproject/smarty/libs"—— 注意结尾是/libs，不是/smarty或/smarty/libs/ - 改完必须重启Apache，且要确认改的是正在使用的php.ini：XAMPP通常有两个，
D:/xampp/php/php.ini（CLI用）和D:/xampp/apache/bin/php.ini（Web用），后者才是关键
缓存不更新、模板修改后页面不变
这不是Smarty“卡住”，而是caching开关开着但没配cache_lifetime或没清旧缓存。开发阶段建议关缓存，而非依赖自动清理。
XAMPP 8.0.30
下载
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
实操建议：
- 开发时直接禁用：
$smarty->caching = false;（别设0，Smarty 3+要求布尔值） - 若必须开缓存，设短生命周期：
$smarty->cache_lifetime = 5;（5秒），避免反复手动清 - 不要依赖
clear_all_cache()写在页面里——它只清当前请求生效的缓存，且需确保cache_dir路径正确、有写权限；更稳妥的是删掉cache/目录下所有文件再刷新 - 注意
is_cached()返回true时，assign()的数据根本不会被处理，整个跳过逻辑层——这点常被忽略，导致“改了PHP却没反应”
Webman等常驻进程框架下templates_c并发写冲突
在Webman、Swoole这类多worker常驻模型里，多个进程同时往同一个templates_c目录写编译文件，会导致PHP编译文件内容损坏、语法错误甚至空白页。
实操建议：
- 绝不能每个请求都
new Smarty()，必须注册为容器单例，在服务启动时初始化一次 -
templates_c目录路径必须唯一且隔离，推荐用worker ID做后缀：templates_c_worker_'. getmypid() .'，或直接用系统临时目录 - 禁用
$smarty->setCacheDir()，常驻进程里缓存机制极易失效，不如用Redis等外部存储做页面级缓存 - Smarty 3.1.9+支持
setCompileLocking(false)，但仅缓解竞争，不解决根本问题——路径隔离才是关键
真正卡住人的从来不是“怎么装”，而是templates_c目录权限、include_path末尾斜杠、多worker下的路径冲突这三处细节。改完配置不重启Apache、在子目录里用相对路径、把缓存目录设成只读——这些操作看起来微小，却能让整个流程彻底断掉。
