织梦模板文件编码统一设置

织梦DedeCMS在模板开发与迁移过程中，编码不一致是引发乱码的常见根源。本文围绕模板文件编码统一设置展开，帮助站长从源头解决因编码混用导致的页面异常问题。

一、织梦编码不一致的原因分析

织梦CMS存在 UTF-8 和 GBK 两种版本，模板文件必须与程序版本严格对应。常见编码问题主要由以下几种情况引发：

1. 程序版本与模板编码不匹配

网站程序使用 UTF-8 版本，而下载或购买的模板是 GBK 编码，直接套用后中文出现乱码。

2. 编辑器保存编码错误

使用记事本或部分编辑器另存文件时，默认添加 BOM 头或转换为其他编码，导致 PHP 解析出错。

3. 数据库编码与页面编码不统一

数据库表使用 latin1 或 gbk，而页面声明 UTF-8，读取数据时中文字段显示为问号或乱码字符。

二、编码统一设置完整步骤

1. 确认程序版本

登录织梦后台，进入「系统」-「系统基本参数」，查看版本信息。也可查看 /data/common.inc.php 文件中的数据库配置，确认 $cfg_db_language 参数：

// data/common.inc.php
$cfg_db_language='utf8';  // UTF-8版本
$cfg_db_language='gbk';   // GBK版本

2. 批量转换模板文件编码

将 /templets/ 目录下所有 .htm 模板文件统一转换为目标编码。推荐使用 Notepad++ 或 VS Code 批量处理：

Notepad++ 操作步骤：
1. 打开模板文件
2. 菜单栏「编码」-「转为UTF-8编码」（不含BOM）
3. 保存文件

VS Code 操作步骤：
1. 打开文件
2. 点击右下角编码标识
3. 选择「通过编码保存」-「UTF-8」

3. 清除 BOM 头

BOM 头会导致 PHP session_start() 报错和页面顶部出现空白行。使用以下脚本批量清除：

// 保存为 clean_bom.php 上传到根目录运行

4. 数据库编码校对

登录 phpMyAdmin，检查数据表编码是否与程序一致。UTF-8 版本对应的校对规则为 utf8_general_ci，GBK 版本对应 gbk_chinese_ci。执行以下 SQL 修正：

ALTER DATABASE dedecms DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
ALTER TABLE dede_archives CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci;

三、配置示例与常见场景

场景：搬迁服务器后全站乱码

多因新服务器 MySQL 默认编码不同导致。在 common.inc.php 中强制指定连接编码：

// 在数据库连接后追加
mysql_query("SET NAMES 'utf8'",$cfg_db);
// DedeCMS V5.7+ 使用 mysqli
$cfg_db->query("SET NAMES 'utf8'");
修改编码前务必完整备份数据库和模板文件，编码转换是不可逆操作，操作失误可能导致数据永久损坏。

四、注意事项

1. 避免使用记事本编辑

Windows 记事本保存 UTF-8 文件时会自动添加 BOM 头，建议始终使用专业编辑器。

2. 静态生成目录需同步检查

开启 HTML 生成的站点，/data/tplcache/ 缓存文件残留旧编码内容时也会导致乱码，转换编码后需清理该目录。

3. 第三方插件编码兼容

安装插件前先核对编码版本，GBK 版插件不能用于 UTF-8 程序，反之亦然。

建立一套规范的编码管理流程，能从根本上杜绝织梦站点乱码问题。建议在项目初期即明确编码标准，对所有参与开发的人员统一要求，并定期使用编码检测工具扫描模板目录，确保整站编码一致性。掌握上述设置方法后，即使面对多套模板混用或服务器迁移场景，也能快速完成编码统一化处理。