Composer命令行中文乱码主因是终端、PHP运行时与系统编码未对齐；需实测chcp或locale确认编码，设PHP default_charset=UTF-8，重启终端生效。
Composer 命令行输出中文乱码，不是 Composer 本身的问题，而是终端、PHP 运行时、系统编码三者没对齐。光改 composer.json 或重装 Composer 没用。
确认当前终端实际编码（Windows / macOS / Linux）
别信“我以为是 UTF-8”——必须实测：
- Windows CMD：运行
chcp，输出活动代码页: 936表示 GBK，65001才是 UTF-8 - Windows PowerShell：运行
[console]::OutputEncoding，返回System.Text.UTF8Encoding才可靠 - macOS / Linux：运行
locale，重点看LANG和LC_CTYPE是否含UTF-8（如zh_CN.UTF-8或en_US.UTF-8）
强制 PHP 启动时使用 UTF-8 编码（关键一步）
Composer 是 PHP 脚本，它的输出编码由 PHP 运行时决定。即使终端是 UTF-8，PHP 默认仍可能按系统 locale 解析输入/输出。
- 临时生效：在执行
composer前，先设环境变量：set PYTHONIOENCODING=utf-8（Windows CMD）export PYTHONIOENCODING=utf-8（macOS/Linux）——别被名字误导，这个变量也影响 PHP 的标准流 - 更可靠方式（推荐）：设置
PHP_CLI_SERVER_ENCODING=utf-8（PHP 7.4+ 支持），或直接用php -d default_charset=UTF-8 /path/to/composer.phar - 永久方案：在
php.ini中加一行default_charset = "UTF-8"，然后重启 CLI 环境（注意：不是 Web 服务器的 php.ini）
VSCode 集成终端跑 Composer 仍乱码？检查三个配置层
VSCode 的终端不是“透明管道”，它叠加了编辑器自身逻辑、Shell 初始化、系统环境三重控制。
- 第一层：VSCode 设置中确认
"files.encoding": "utf8"和"terminal.integrated.defaultProfile.windows": "PowerShell"（避免用老旧的 CMD） - 第二层：PowerShell 启动脚本（如
$PROFILE）里加：$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding - 第三层：VSCode 的
settings.json加终端预启动命令："terminal.integrated.shellArgs.windows": [ "-NoExit", "-Command", "chcp 65001 > $null" ]
Composer install/update 中文包名报错或显示为 ？
这通常不是终端乱码，而是 composer.lock 或 vendor/ 下文件路径含中文，而某些 Windows 文件系统或 Git 配置不支持 UTF-8 路径。
- 检查 Git 是否启用 UTF-8 路径支持：
git config --global core.precomposeUnicode true（macOS）或git config --global core.quotePath false（Windows） - 避免在项目路径、包名、
name字段中使用中文——Composer 官方不保证路径级中文兼容性，尤其跨平台协作时 - 如果必须处理中文依赖（如私有包），确保
composer.json文件本身以 UTF-8 无 BOM 保存，并在 PHP 脚本中用mb_internal_encoding('UTF-8')显式声明
最易被忽略的一点：修改完任何一层编码设置（系统区域、终端 profile、PHP 配置、VSCode settings），都必须**完全关闭并重启终端进程**——残留的子 shell 或缓存的 stdio 编码状态不会自动刷新，哪怕只差一次重启，前面所有配置都白调。
