PHP中文乱码主因是文件编码非UTF-8、未设置Content-Type响应头、HTML meta与header不一致、终端代码页不匹配及BOM/服务器配置干扰;需统一用UTF-8编码保存文件、开头加header('Content-Type: text/html; charset=utf-8')、确保meta charset="utf-8"与之严格一致,并在终端执行chcp 65001(Windows)或配置locale(Linux/macOS)。

PHP 文件本身编码不是 UTF-8 会导致 echo 中文变问号或方块
VS Code 默认新建文件用 UTF-8,但老项目里很多 .php 文件是 GBK 或 GB2312 编码保存的。此时即使你在 HTML 里写了 ,PHP 解析器读取源码时就已出错,echo "你好"; 输出的其实是乱字节流。
- 在 VS Code 右下角查看当前文件编码(如显示
GBK或ISO 8859-1),点击它 → 选择Save with Encoding→ 改为UTF-8 - 改完后务必检查中文是否仍正常显示在编辑器内;若变成方块或问号,说明原内容确实是 GBK 编码,需先选
Reopen with Encoding→GBK,再另存为 UTF-8 - 不建议用记事本转码,容易丢字符;VS Code 的编码转换对中文兼容性较好
PHP 输出未声明 Content-Type 或 charset 导致浏览器乱码
PHP 默认输出的 HTTP 响应头不含 Content-Type,浏览器靠自身逻辑猜编码,大概率猜错。尤其在 CLI 模式运行或通过 Apache 直接访问时更明显。
- 在 PHP 文件最开头(
后立即)加:header('Content-Type: text/html; charset=utf-8'); - 如果用了框架(如 Laravel、ThinkPHP),通常已内置该 header,但自定义路由或纯 PHP 脚本容易遗漏
- 避免在
header()前有任何输出(包括空格、BOM、echo),否则会报Warning: Cannot modify header information
HTML 页面 meta 标签和 PHP header 冲突或不匹配
当 header('Content-Type: ...') 和 不一致时,现代浏览器优先信 header,但部分旧版 IE 或微信内置浏览器可能 fallback 到 meta,造成不一致表现。
- 两者必须严格一致:都用
utf-8(注意全小写,不带横线) - 不要写成
UTF8、UTF-8(虽然多数情况兼容,但 PHP 的header对大小写敏感,某些 Nginx 配置下会失效) - 检查 HTML 是否有多个
,重复声明可能导致解析异常
终端/CLI 下运行 PHP 时中文输出乱码(非浏览器场景)
在 VS Code 集成终端(Terminal)里执行 php test.php,即使文件和代码都正确,Windows 的 cmd/powershell 默认用 GBK,而 PHP 输出 UTF-8 字节,就会显示为乱码。
立即学习“PHP免费学习笔记(深入)”;
- 临时方案:在终端执行
chcp 65001(切换为 UTF-8 代码页),再运行 PHP - 长期方案:在 VS Code 设置中搜
terminal.integrated.defaultProfile.windows,改为Windows PowerShell,并在其配置中启用 UTF-8(PowerShell 7+ 默认支持) - Linux/macOS 一般无此问题,但若 locale 是
C或POSIX,需确保LANG=en_US.UTF-8已生效
charset 指令、Apache 的 AddDefaultCharset 都可能覆盖 PHP 的设置,真遇到顽固乱码,先用 curl -I http://your-site/test.php 看响应头里的 Content-Type 是什么,比猜更可靠。











