PhpStorm调试代码时控制台输出乱码的解决方法-phpstorm-PHP中文网

根本原因是终端编码与php脚本/系统locale不一致；须统一文件编码（utf-8无bom）、php.ini default_charset、phpstorm terminal与run/debug console编码、系统区域设置及jvm参数，缺一不可。

phpstorm调试代码时控制台输出乱码的解决方法

根本原因是终端编码与 PHP 脚本/系统 locale 不一致，常见于 Windows 默认 GBK 环境下运行 UTF-8 编码的脚本。PhpStorm 的 Run 和 Debug 控制台共用同一终端配置，但调试时还叠加了 Xdebug 的字符处理路径，容易放大乱码问题。

先确认 PHP 文件本身保存为 UTF-8 无 BOM（用 Notepad++ 或 VS Code 查看编码）
检查 php.ini 中是否设置了 default_charset = "UTF-8"（非必需但建议统一）
Windows 用户重点检查系统区域设置：控制面板 → 区域 → 管理 → 更改系统区域设置 → 勾选“Beta 版：使用 Unicode UTF-8 提供全球语言支持”（重启生效）

Terminal（底部标签页）和 Run/Debug 控制台是两套独立编码配置，很多人只改了其中一个，导致调试时正常、终端执行却乱码，或反之。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

Terminal 编码在 Settings → Tools → Terminal → Shell path 下方的 Encoding 选项中设置，建议选 UTF-8
Run/Debug Console 编码在 Settings → Editor → File Encodings 中修改：Global Encoding、Project Encoding、Default encoding for properties files 全部设为 UTF-8
关键一步：勾选 Transparent native-to-ascii conversion（尤其对 properties 文件），否则中文会被转成 \u4f60\u597d 形式输出

这不是编码问题，而是 PhpStorm 控制台对 ANSI 转义序列或宽字符（如 emoji、中文全角符号）渲染异常，尤其在启用 Xdebug 的 cli 模式下。

避免在调试中混用 echo 和 var_dump() 输出大量中文结构体，优先用 error_log() 写入文件再查看
在 php.ini 中临时添加 xdebug.cli_color=0，关闭 Xdebug 的彩色输出，可缓解部分错位
若用 print_r($arr, true) 拼接日志，确保接收变量的上下文也以 UTF-8 处理，例如写入文件前加 mb_convert_encoding($str, 'UTF-8', 'auto')

本地集成环境自带的 PHP CLI 可能未继承系统 UTF-8 设置，尤其 Windows 上 WampServer 默认调用的是 c:\wamp64\bin\php\phpX.X.X\php.exe，它可能读取了旧版 php.ini 或忽略系统 locale。

在 PhpStorm 的 Run → Edit Configurations → PHP Script 中，手动指定 CLI 解释器路径，并点击右侧 … 查看其关联的 php.ini 路径是否正确
运行 php -i | findstr "Loaded Configuration File" 确认实际加载的 php.ini，然后在该文件末尾追加：
```
default_charset = "UTF-8"
[mbstring]
mbstring.language = Neutral
mbstring.internal_encoding = UTF-8
```
改完后重启 PhpStorm，且务必点击 File → Invalidate Caches and Restart → Just Restart，否则缓存的编码设置可能继续生效