网站从windows-1251切换为UTF-8时Content-Type charset不生效怎么办

注意：HTML页面内的meta charset标签优先级低于HTTP响应头中的Content-Type字段，只要响应头指定了windows-1251，meta配置不会生效

1. 优先检查文件解析规则 #

你当前直接访问后缀为.html的文件，默认XAMPP的Apache配置仅会对.php后缀的文件执行PHP解析，写在index.html开头的<?php header('Content-type: text/html; charset=utf-8'); ?>代码完全不会生效，甚至会作为普通文本输出到响应体中，优先级低于Apache全局对静态文件的编码配置。
解决方法二选一：

• 将index.html重命名为index.php，访问http://localhost:8080/index.php，让PHP头部配置生效
• 修改Apache配置，强制.html文件走PHP解析（不推荐，会带来不必要的性能损耗）

2. 修改Apache全局静态文件编码配置 #

XAMPP默认的Apache配置中可能给静态.html文件强制指定了编码为windows-1251，这是你当前响应头编码异常的核心原因之一，操作步骤：

1. 打开XAMPP安装目录下的apache/conf/httpd.conf文件
2. 查找AddDefaultCharset配置项：
   • 若配置值为AddDefaultCharset windows-1251，直接修改为AddDefaultCharset UTF-8
   • 若不需要全局默认编码，也可以在配置行前加#注释掉该规则
3. 查找是否存在AddCharset windows-1251 .html .htm这类强制指定静态文件编码的配置，如有则修改为UTF-8或注释
4. 保存配置后重启Apache服务

3. 检查站点目录.htaccess规则 #

如果你的站点根目录存在.htaccess文件，检查是否有强制指定编码的规则：

• 查找是否存在AddDefaultCharset windows-1251或者Header set Content-Type "text/html; charset=windows-1251"这类规则，修改为UTF-8即可生效

4. 确认Smarty模板编码配置 #

如果后续是通过PHP渲染Smarty模板输出页面，需要额外确认Smarty本身的编码配置：

• 检查Smarty初始化代码中是否指定了编码，高版本Smarty配置为$smarty->setEncoding('UTF-8');，低版本配置为$smarty->default_charset = 'UTF-8';
• 清空Smarty缓存目录下的所有旧缓存，避免旧的windows-1251编码缓存被直接返回

5. 排查文件编码格式 #

确认你修改后的所有代码文件（index.php、Smarty模板、静态html文件）都是UTF-8 无BOM格式，如果是带BOM的UTF-8编码，BOM头会作为输出内容提前发送，导致PHP header函数失效，同时也可能触发浏览器编码识别错误。可以用VS Code、Notepad++等编辑器查看和修改文件编码格式。

内容的提问来源于stack exchange，提问作者klm123