织梦DedeCMS模板变量未定义排查与修复
模板变量未定义通常由标签语法错误、变量未声明或缓存未更新导致，需通过语法校验、作用域检查及缓存清理解决。
问题原因
- 网站模板变量作用域错误：在非对应循环体/区块外调用局部变量
- 标签语法校验失败：标签闭合符缺失或属性值未用引号包裹（如
{dede:field.xx}漏写/） - 动态参数配置遗漏：后台未维护「系统参数」→「模板变量」中的必要字段
- 模板缓存未更新：修改模板后未刷新「系统」→「更新系统缓存」
- 模板继承关系断裂：子模板未通过
{dede:include}正确继承父模板变量
解决方法
| 解决方向 | 具体操作 |
|---|---|
| 校验标签完整性 | 检查{dede:arclist}等标签是否闭合，变量名是否包含空格等非法字符 |
| 声明全局变量 | 在后台「系统」→「系统基本参数」添加缺失的模板变量 |
| 强制刷新模板缓存 | 删除/data/tplcache/目录下所有.inc文件 |
| 检查变量作用域 | 在循环体外调用字段时改用{dede:field name='xx' runphp='yes'}动态获取 |
| 修正模板继承逻辑 | 父模板使用{dede:global.xx/}定义变量，子模板用{dede:include}引入 |
注意事项
- 修改模板前备份
/templets/目录及/data/common.inc.php文件 - 变量名严格遵循驼峰命名法，禁用
$、#等特殊符号 - 动态页需在「栏目管理」中指定对应模板文件路径
- 使用
{dede:php}print_r($GLOBALS);{/dede:php}调试全局变量 - 开启「模板调试模式」：后台→系统→系统错误修复→勾选「模板引擎调试」
- 涉及SQL查询的标签需确保关联字段存在于
dede_archives等主表中
更新时间：2025-04-17 10:01:41