Windows10下VSCode中Xdebug调试PHP韩文异常消息编码乱码问题

以下是针对Windows 10环境下的具体解决步骤：

VSCode端配置调整 #

• 打开VSCode设置（快捷键Ctrl+,），搜索并设置以下选项：
  • debug.console.encoding：设为utf8，确保调试控制台用UTF-8编码解析输出内容
  • files.encoding：设为utf8，保证编辑器对文件编码的识别统一
  • terminal.integrated.encoding：若调试信息在集成终端输出，同样设为utf8

PHP与Xdebug编码配置强化 #

1. 补充php.ini编码相关配置（修改后重启Web服务器/PHP-FPM生效）：

   default_charset = "UTF-8"
   mbstring.internal_encoding = UTF-8
   mbstring.http_output = UTF-8
   mbstring.encoding_translation = On
   

2. 添加Xdebug客户端通信编码配置（适用于Xdebug 3.x版本）：
   在php.ini中加入：

   xdebug.client_encoding = "UTF-8"
   

   该配置强制Xdebug与VSCode之间的通信使用UTF-8，避免编码转换异常

额外验证项 #

• 确认抛出异常的字符串本身为UTF-8编码（源码已设为UTF-8的情况下一般无需额外处理，可通过mb_detect_encoding()函数快速验证）
• 检查VSCode区域设置：搜索locale，确保设置为支持UTF-8的区域（如ko-KR或en-US）

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