Windows下Composer乱码主因是终端GBK与PHP输出UTF-8不匹配，需依次解决：chcp 65001切换代码页、php.ini设default_charset和mbstring.internal_encoding为UTF-8、Git Bash调UTF-8编码、升级Composer至2.5+并启用mbstring/iconv扩展。
Windows CMD/PowerShell 中 Composer 输出乱码
根本原因是 Windows 控制台默认使用 GBK 编码，而 Composer（基于 PHP）在输出 UTF-8 字符（如中文包名、错误提示、emoji）时未做编码适配，导致显示为问号或方块。
临时解决只需一行命令切换当前窗口编码：
chcp 65001
这会把当前 CMD 或 PowerShell 的活动代码页设为 UTF-8。但注意：该设置仅对当前窗口有效，关闭后失效。
若需永久生效（推荐用于开发环境），可修改注册表或启动脚本：
- 对 CMD：在
cmd.exe快捷方式的「属性 → 选项」中勾选「使用旧版控制台」——**不推荐**，会丢失部分 Unicode 支持 - 对 PowerShell：在用户配置文件（
$PROFILE）末尾添加chcp 65001 > $null - 更稳妥的做法是改用 Windows Terminal，并将默认配置的
fontFace设为支持 UTF-8 的字体（如 "Cascadia Code", "Fira Code"）
PHP 内部输出编码未同步导致 Composer 日志乱码
即使终端已设为 UTF-8，Composer 执行过程中调用的 PHP 脚本仍可能因 mb_internal_encoding() 或 default_charset 设置不当，导致日志写入或异常堆栈出现乱码。
检查并统一 PHP 编码设置：
- 运行
php -i | findstr "default_charset mbstring.internal_encoding"（Windows）或php -i | grep -E "(default_charset|mbstring\.internal_encoding)"（macOS/Linux） - 确保两者均为
UTF-8（注意大小写，必须是UTF-8，不是utf8） - 若不一致，在
php.ini中显式设置：default_charset = "UTF-8"mbstring.internal_encoding = UTF-8 - 修改后重启 CLI 环境（关掉所有终端再重开），再运行
composer diagnose观察输出是否正常
Git Bash 下 Composer 中文路径或包名显示异常
Git Bash 默认使用 mintty 终端，其编码行为与原生 Windows 控制台不同；常见现象是中文 vendor 目录名显示为 \344\273\245\345\216\20e... 这类八进制转义，本质是 UTF-8 字节被当成 Latin-1 解析。
修复步骤很直接：
- 右键 Git Bash 窗口标题栏 →「Options…」→「Text」→ 将「Locale」设为
zh_CN或en_US，「Character set」设为UTF-8 - 确认环境变量未强制覆盖：
echo $LANG应输出类似zh_CN.UTF-8或en_US.UTF-8；若为C或空，可在~/.bashrc中追加：export LANG=en_US.UTF-8 - 避免在
composer.json的name或description字段里混用全角标点——某些 Composer 版本解析时会截断或转义失败
Composer 自身版本与 PHP 多字节处理兼容性问题
较老版本的 Composer（如 1.x 系列）在 PHP 8.1+ 上对 Unicode 文件名、路径的处理存在缺陷，尤其在 Windows 下执行 composer update 遇到含中文的 vendor 子目录时可能报错或跳过安装。
这不是字符编码设置能绕过的，必须升级：
- 运行
composer self-update升级到最新稳定版（目前 2.5+） - 确认 PHP 版本 ≥ 7.2.5（Composer 2 要求），且启用了
mbstring和iconv扩展（php -m | findstr "mbstring iconv"） - 若仍出问题，临时禁用 vendor 目录缓存：
composer config -g store-auths false，并清空COMPOSER_HOME/cache目录
真正麻烦的不是设置编码，而是多个层级（终端 → PHP 运行时 → Composer 内核 → 文件系统 API）之间 UTF-8 流转时任意一环漏掉声明或转换。一个看似“只是显示乱”的问题，往往要逐层验证才定位得到。
